Markdown 마크다운

Markdown은 텍스트 기반의 경량 마크업 언어로, 웹 콘텐츠 작성을 간편하게 할 수 있게 설계되었습니다. Markdown 문서는 단순하고 읽기 쉬우며, HTML로의 변환도 간단합니다. GitHub, Reddit, Discord 등 많은 플랫폼에서 널리 사용됩니다. 특히 TradingClue의 GitHub를 활용한 사업계획서 작성에 사용될 예정이라 간단히 소개합니다.

업데이트 2025-05

읽는 시간 7분

글쓰기·도구

2004

출시

John Gruber

창시자

CommonMark

표준

GitHub·Notion

주요 사용처

Quick Answer

Q. 마크다운을 배워야 하는 이유는 무엇인가요?

한 번 익히면 GitHub, Notion, Obsidian, Discord, Slack, 기술 블로그, AI 챗봇 등 거의 모든 디지털 글쓰기 도구에서 동일하게 사용할 수 있는 “디지털 시대의 펜글씨”입니다. 학습 시간 10분.

한눈에 보기 (TL;DR)

  1. 마크다운은 2004년 John Gruber가 만든 경량 마크업 언어.
  2. 기본 문법: # 헤딩, ** 굵게, * 기울임, [텍스트](URL), – 리스트, > 인용.
  3. 표준: CommonMark (2014) + GitHub Flavored Markdown (GFM).
  4. 주요 사용처: GitHub, Notion, Obsidian, Discord, Slack, ChatGPT, Claude.
  5. 확장: 표, 수식(KaTeX), 다이어그램(Mermaid), 체크박스.

Key Facts — 마크다운 기본 문법

요소문법
헤딩# H1, ## H2, ### H3
강조**bold**, *italic*
링크[text](url)
이미지![alt](url)
리스트– item, 1. item
코드`code`, “`block“`

출처: Daring Fireball Markdown Syntax, CommonMark Spec, GitHub Flavored Markdown

핵심 인사이트

마크다운은 “형식 강제”가 아니라 “형식의 자유와 일관성을 동시에 주는 도구” — 작가의 디지털 인프라.

Markdown 마크다운 이란?

Markdown은 텍스트 기반의 경량 마크업 언어로, 웹 콘텐츠 작성을 간편하게 할 수 있게 설계되었습니다. Markdown 문서는 단순하고 읽기 쉬우며, HTML로의 변환도 간단합니다. GitHub, Reddit, Discord 등 많은 플랫폼에서 널리 사용됩니다. 특히 TradingClueTM의 GitHub를 활용한 사업계획서 작성에 사용될 예정이라 간단히 소개합니다.

기본적인 문법

1. 헤더 (Headers)

Markdown에서 헤더를 만들기 위해서는 # 기호를 사용합니다. #의 개수가 많아질수록 헤더의 레벨이 낮아집니다(크기가 작아집니다 – H1,H2 Tag 언어와 유사합니다.).

# 헤더 1
## 헤더 2
### 헤더 3
#### 헤더 4
##### 헤더 5
###### 헤더 6
2. 강조 (Emphasis)

텍스트를 강조하기 위해 볼드체나 이탤릭체를 사용할 수 있습니다.

*이탤릭체* 또는 _이탤릭체_
**볼드체** 또는 __볼드체__
**_이탤릭체와 볼드체_**
~~취소선~~
3. 목록 (Lists)

순서가 있는 목록과 순서가 없는 목록을 만들 수 있습니다.

순서가 있는 목록:
1. 첫 번째 항목
2. 두 번째 항목
3. 세 번째 항목

순서가 없는 목록:
- 항목
- 항목
  - 하위 항목
  - 하위 항목
* 또 다른 형태의 항목
 + 또 다른 형태의 항목
4. 링크와 이미지 (Links and Images)

링크와 이미지를 삽입할 수 있습니다.

[트레이딩클루로 가기](https://www.tradingclue.kr)
![이미지](https://example.com/image.png)
5. 코드 (Code)

인라인 코드와 코드 블록을 삽입할 수 있습니다.

<pre><code>{code}</code></pre> 이용방식 
혹은 '''(코드블록코드) 이용방식
6. 인용문
#### 6. 인용문 (Blockquotes)
인용문을 작성할 때는 `>`를 사용합니다.

```markdown
> 이것은 인용문입니다.
> 여러 줄의 인용문을
> 계속해서 작성할 수 있습니다.

이것은 인용문입니다.

여러 줄의 인용문을

계속해서 작성할수 있습니다.

7. 수평선 (Horizontal Rules)

수평선을 추가하려면 세 개 이상의 -, *, 또는 _를 사용합니다.

---
***
___
8. 줄바꿈
* 줄 바꿈을 하기 위해서는 문장 마지막에서 3칸이상을 띄어쓰기해야 한다. 
이렇게

* 줄 바꿈을 하기 위해서는 문장 마지막에서 3칸이상을 띄어쓰기해야 한다.___\\ 띄어쓰기
이렇게

github를 활용한 사업계획서

주요 타임라인

  • 2004John Gruber Markdown 발표
  • 2008GitHub Flavored Markdown 도입
  • 2014CommonMark 표준화
  • 2016Notion 마크다운 단축키 지원
  • 2023ChatGPT·Claude 기본 출력 형식

근거 및 출처

  1. Gruber, J. Markdown Syntax Documentation, Daring Fireball 2004
  2. CommonMark Specification 0.30
  3. GitHub Flavored Markdown Spec
  4. Notion, Markdown shortcuts in Notion

마무리 — 핵심 정리

  • 마크다운은 10분에 익히고 평생 쓰는 도구.
  • GitHub + Notion + Obsidian의 공통 언어가 마크다운.
  • AI 시대에는 LLM의 기본 출력 형식이기도 — 익혀두면 활용도 폭증.

자주 묻는 질문

마크다운은 “읽기 쉬운 단순 표기”로 HTML로 변환되는 경량 언어입니다. HTML이 “태그를 직접 쓰는” 정밀 제어 형식이라면, 마크다운은 “의미 중심의 자연 표기”입니다. 마크다운 안에 HTML 태그도 사용 가능합니다.

CommonMark는 마크다운의 공식 표준(2014)이고, GFM(GitHub Flavored Markdown)은 GitHub가 표·체크박스·자동 링크·언급(@) 등을 추가한 확장입니다. 대부분의 현대 도구가 GFM 호환입니다.

(1) GitHub README·이슈·PR, (2) Notion·Obsidian·Logseq 노트, (3) 기술 블로그(Hugo·Jekyll), (4) Discord·Slack 메시지, (5) ChatGPT·Claude 응답 — 모두 같은 문법을 공유합니다.

확장 형식을 지원하는 도구에서는 가능합니다. KaTeX 수식($a^2 + b^2 = c^2$), Mermaid 다이어그램(flowchart, sequence), Mermaid의 gantt 차트 등이 Notion·GitHub·Obsidian에서 작동합니다.

최종 업데이트: 2025-05 · ChatGPT·Claude 기본 형식, Mermaid 확장 반영