[개발/생산성] 마크다운(Markdown) 문법 총정리: 기본부터 GitHub·옵시디안 확장 문법까지
안녕하세요 가야태자 @talkit 입니다. ^^
오랜만에 블로그 분석을 해보니 마크다운 관련 글이 여전히 인기 순위 1위를 달리고 있네요. 많은 분이 마크다운에 관심을 두시는 모습을 보며, '도대체 마크다운 문법의 끝은 어디일까? 기본 문법부터 깃허브나 옵시디안 같은 플랫폼 전용 확장 문법까지 한눈에 정리해 두면 어떨까?' 하는 궁금증과 욕심이 생겼습니다.
📝 마크다운(Markdown)이란?
마크다운은 텍스트 기반의 경량 마크업 언어입니다. 복잡한 HTML 태그를 쓰지 않고도 #, * 같은 단순한 기호 몇 개로 글을 보기 좋게 꾸밀 수 있어, 개발자 문서 문서화부터 블로그 포스팅, 개인 메모까지 폭넓게 사랑받고 있습니다. 무엇보다 텍스트 그대로 읽어도 가독성이 좋고, 플랫폼에 종속되지 않는다는 강력한 장점이 있습니다.
📌 1. 마크다운 기본 문법 (Standard Markdown)
가장 기초가 되며 대부분의 편집기에서 호환되는 필수 문법입니다.
제목 (Headers):
#의 개수로 크기를 조절합니다 (1~6단계).# 제목 1 (가장 큼) ## 제목 2 ### 제목 3강조 (Emphasis): 텍스트를 굵게 하거나 기울입니다.
*기울임* 또는 _기울임_ **굵게** 또는 __굵게__목록 (Lists): 순서가 있는 목록และ 없는 목록을 만듭니다.
1. 첫 번째 2. 두 번째 * 순서 없는 목록 - 대시도 가능합니다구분선 (Horizontal Rule): 하이픈 세 개(
---) 혹은 별표 세 개(***)를 연속으로 입력하면 글의 섹션을 나누는 깔끔한 가로줄(구분선)이 생성됩니다.---링크 & 이미지 (Links & Images): URL과 이미지를 삽입합니다.
[구글 링크](https://google.com) 인용구 (Blockquotes):
>기호를 사용합니다.> 이것은 인용문입니다.
🐙 2. GitHub 확장 문법 (GFM: GitHub Flavored Markdown)
개발자들의 성지인 GitHub에서 코드와 협업 관리를 편리하게 하기 위해 확장한 문법입니다.
- 코드 블록 (Code Blocks) & 언어 강조: 백틱( ` ) 3개로 코드를 감싸고 언어 이름을 적으면 문법 하이라이팅이 적용됩니다.
``````java public class HelloWorld { public static void main(String[] args) { System.out.println("Hello, World!"); } } - 체크박스 / 작업 목록 (Task Lists): 대괄호 안에 공백이나
x를 넣어 만듭니다.- [ ] 해야 할 일 - [x] 완료된 일 - 취소선 (Strikethrough): 물결표(
~) 2개로 텍스트를 감싸줍니다.~~이 내용은 취소되었습니다.~~ - 표 (Tables): 파이프(
|)와 대시(-)를 이용해 깔끔한 표를 그립니다.| 제목 | 내용 | 비고 | | :--- | :---: | ---: | | 왼쪽 정렬 | 중앙 정렬 | 오른쪽 정렬 |
💎 3. 옵시디안 확장 문법 (Obsidian Markdown)
두번째 뇌로 불리는 지식 관리 도구, 옵시디안(Obsidian)에서 주로 쓰이는 강력한 연결 문법입니다.
위키 링크 / 내부 문서 연결 (Wiki Links): 대괄호 2개
[[ ]]를 사용해 노트와 노트를 번개처럼 연결합니다.[[마크다운 편집기 사용법]] -> 해당 이름의 내부 노트로 링크 생성 [[마크다운 편집기 사용법|여기]] -> '여기'라는 이름으로 별칭 링크 생성텍스트 하이라이트 (Highlight): 등호(
=) 2개로 형광펜 효과를 줍니다.==이 부분은 중요해서 형광펜을 칠합니다.==태그 (Tags):
#뒤에 띄어쓰기 없이 단어를 적어 분류 태그를 만듭니다. (일반 제목 문법과 달리 본문 중간에 배치)#마크다운 #블로그분석 #옵시디안각주 (Footnotes): 본문 중간에 보충 설명 링크를 달고 하단에 내용을 적습니다.
이 문장 뒤에 추가 설명이 필요합니다[^1]. [^1]: 여기에 각주 내용을 작성합니다.
📂 4. 내 블로그 참고글 목록
그동안 제가 블로그에 차곡차곡 정리해 두었던 마크다운의 역사, 개념, 편집기 추천 및 활용 플랫폼에 관한 연재 글입니다. 함께 읽어보시면 마크다운을 마스터하는 데 큰 도움이 됩니다!
- [개발/생산성] 왜 모두가 마크다운(Markdown)에 열광할까? 개요부터 역사까지 총정리
- [무료소프트웨어] 마크다운/Markdown 편집기/Editor 마크텍스트/MarkText 다운로드 및 설치하기
- [무료소프트웨어/부분유료?] 개인용 지식관리 시스템 옵시디언. Personal knowledge base Obsidian
- 윈도우, 맥, 리눅스를 모두 지원하는 유명 마크다운 편집기 추천
- 마크다운을 기본으로 제공하는 플랫폼 총정리: 블로그, SNS, 협업 도구까지
🔗 관련 참고 링크
마크다운을 더 깊게 공부해 보시거나 유용하게 활용할 수 있는 공식 문서 링크입니다.
방문해 주시는 분들께 유익한 정리 글이 되었으면 좋겠습니다. 궁금한 점이 있다면 언제든 댓글로 남겨주세요. 감사합니다!
