개발 기본
마크다운(Markdown)
마크다운은 #, -, ** 같은 텍스트 기호로 제목·목록·강조를 표시하는 문서 작성 문법입니다.
쉬운 설명
마크다운은 글자 앞뒤에 간단한 기호를 붙여 문서의 구조를 표현하는 방법이에요. 예를 들어 제목 앞에는 #과 공백을, 목록 앞에는 -와 공백을 붙여요. 이를 지원하는 화면에서는 기호가 제목이나 목록 모양으로 바뀌어 보여요. 프로젝트 소개 파일인 README.md나 AI에게 줄 작업 지시문에서 자주 만나게 돼요.
이런 상황에서 만나요
AI가 프로젝트 사용법을 README.md에 적어 줬는데, 파일을 열어 보니 #과 ** 같은 기호가 보일 수 있어요. 잘못 생성된 문자가 아니라 문서 모양을 지정하는 마크다운 문법이에요. 같은 내용을 원문과 미리보기로 보면 차이를 알 수 있어요.
# 스터디 실습
- 파일 열기
- **결과 확인**- 파일 열기
- 결과 확인
- 1원문: #과 공백은 제목, -와 공백은 목록, **는 굵은 강조를 나타냅니다.
- 2미리보기: 같은 내용을 마크다운 문법에 따라 표시한 모습입니다.
편집기의 마크다운 미리보기나 게시할 서비스의 미리보기를 열어 보세요. 제목, 목록, 강조가 의도한 대로 보이는지 확인한 뒤 저장하거나 게시하면 돼요. 코드 설명을 붙여 넣을 때는 코드 블록을 사용하면 들여쓰기와 기호를 구분해 읽기 쉬워요.
헷갈리기 쉬운 점
마크다운으로 쓰면 AI가 지시를 더 잘 따르나요?
제목과 목록으로 목표·조건·예시를 구분하면 지시문을 정리하고 확인하기 편해요. 하지만 마크다운 기호를 쓴다고 AI가 내용을 정확히 이해하거나 반드시 지키는 것은 아니에요. 무엇을 해야 하고 어떤 결과가 필요한지 구체적으로 쓰는 것이 먼저예요.
마크다운을 지원하지 않는 입력란에서는 기호가 그대로 보일 수 있어요. 표나 체크박스 같은 확장 문법도 서비스마다 지원 범위가 달라요. 작성한 편집기에서 잘 보여도 최종 게시 화면에서 다시 확인하세요.
왜 알아야 할까요?
AI가 만든 README나 스터디 실습 문서를 직접 고칠 수 있어요. 오류 메시지와 코드를 질문 글에 붙일 때도 본문과 구분해서 보여 줄 수 있어, 답변하는 사람이 내용을 읽기 편해집니다.
조금 더 자세히
마크다운 파일은 일반 텍스트 파일이며 보통 .md 확장자를 사용합니다. 화면에 보여 주는 도구가 문법을 해석해 제목이나 목록 등의 모양으로 표시합니다. 원문을 편집할 때 기호가 보이는 것은 정상입니다.
제목은 # 뒤에 공백을 넣어 쓰며 ##, ###처럼 개수로 단계가 달라집니다. **글자**는 굵은 강조, - 뒤에 공백을 넣은 줄은 목록을 나타냅니다. 링크는 [보여 줄 글자](주소) 형태로 씁니다. 문법 예시는 미리보기와 함께 확인하는 편이 이해하기 쉽습니다.
코드를 여러 줄 넣을 때는 앞뒤를 백틱 세 개로 감싸 코드 블록으로 구분할 수 있습니다. 시작하는 백틱 뒤에 javascript처럼 언어 이름을 적으면 지원하는 도구에서 코드 색상 표시를 적용합니다. GitHub의 표나 작업 목록처럼 기본 문법을 확장한 기능도 있으므로 사용하는 서비스의 문서를 확인합니다.
직접 사용할 때 확인해 보세요
- 원문과 미리보기를 구분해서 확인한다
- 제목 단계와 목록을 내용에 맞게 쓴다
- 게시할 서비스에서 링크와 코드 블록이 제대로 보이는지 확인한다
관계 지도
