GitHub 초보자를 위한 Markdown 입문

Markdown은 GitHub에서 쓰는 가벼운 텍스트 포맷 문법이다. README, issue, pull request, agent instruction files, discussion, wiki, 댓글에 적용할 수 있고, 일부 HTML 태그도 함께 쓸 수 있다. Markdown을 익히면 문서가 더 읽기 쉬워지고, GitHub 밖의 노트 앱과 문서 도구에서도 그대로 활용할 수 있다.

실습은 저장소의 Code 탭에서 Add file > Create new file로 .md 파일을 만든 뒤 Edit 화면에 문법을 입력하고 Preview로 확인하면 된다. 커밋은 저장이 필요할 때만 하면 되고, 리스트를 시험한 뒤에는 Enter를 두 번 눌러 일반 텍스트로 돌아간다.

기본 문법은 다음과 같다.

• #, ##, ###처럼 # 개수로 headers를 나눈다.
• * 또는 _ 한 개는 italic, 두 개는 bold, 세 개는 둘 다 적용된다.
• >를 각 줄 앞에 붙여 blockquote를 만든다.
• 번호를 붙이면 ordered list, -, *, +를 쓰면 unordered list가 된다. 순서는 1, 2, 3처럼 맞추지 않아도 되며, Markdown이 자동으로 해석한다. 중첩은 네 칸 들여쓰기로 만든다.
• 백틱 하나로 inline code, 세 개의 백틱으로 여러 줄 code block을 만든다. 세 백틱 안의 공백과 줄바꿈도 그대로 렌더링된다.
• [텍스트](URL)로 link, ![대체텍스트](URL)로 image를 넣는다. GitHub에서는 이미지를 드래그 앤 드롭하면 Markdown이 자동 생성된다.

이 정도만 익혀도 README와 프로젝트 노트를 훨씬 명확하게 정리할 수 있다. 더 자세한 문법은 GitHub Docs의 basic formatting syntax, code blocks, quickstart 가이드에서 이어서 볼 수 있다.