마크다운 문법 요약
미리보기가 그리는 마크다운 요소와 쓰는 법을 표로 정리합니다. 표준(CommonMark)과 GFM(표·할 일·취소선) 위에 확장 문법을 더해 그립니다.
글자와 문단
| 쓰는 법 | 결과 |
|---|---|
**굵게** |
굵게 |
*기울임* |
기울임 |
~~취소선~~ |
|
`코드` |
코드 조각 |
| 빈 줄 | 문단 나누기 |
줄 끝 공백 두 개 또는 \ |
문단 안 줄 바꿈(그냥 줄을 바꾸면 공백) |
블록 요소
# 제목 1
## 제목 2
- 글머리 목록
- 들여쓰면 아래 단계
1. 번호 목록
- [ ] 할 일
- [x] 한 일
> 인용
> [!NOTE]
> 알림 블록
---
| 요소 | 미리보기에서 |
|---|---|
| 할 일 | 미리보기의 상자를 클릭하면 원문의 [ ]·[x]가 바뀝니다 |
| 알림 블록 | NOTE·TIP·IMPORTANT·WARNING·CAUTION 다섯 종류. 표지 뒤 글은 제목이 됩니다 |
| 코드 블록 | 고정폭 글꼴, 복사 버튼 |
| 각주 | 문장[^1]과 [^1]: 본문. 참조는 위첨자 번호, 클릭하면 정의로 갑니다 |
| 문서 속성 | 맨 위 ---로 감싼 이름: 값 줄이 목록으로 보입니다 |
문서 속성은 도구 > 설정 > 미리보기의 「문서 위 속성 표시」로 숨길 수 있습니다.
표
| 이름 | 값 |
|:--|--:|
| 가 | 1 |
:--는 왼쪽,--:는 오른쪽,:-:는 가운데 정렬입니다.- 머리글 행은 음영으로 보이고, 머리글 칸이 모두 비면 머리글 행을 그리지 않습니다.
- 칸 안의
\|,<br>, 굵게·취소선은 그대로 그려집니다.
수식과 다이어그램
| 쓰는 법 | 결과 |
|---|---|
$a^2+b^2=c^2$ |
문장 속 수식 |
$$ … $$ |
블록 수식 |
```mermaid |
mermaid 다이어그램 |
```dot · ```graphviz |
Graphviz 다이어그램 |
$바로 안쪽이 공백이거나 닫는$뒤에 숫자가 오면 수식이 아니라 글자입니다($5와 $10).- 그리지 못한 수식과 다이어그램은 그 자리에 오류 문구가 나옵니다.
링크와 그림
[글](https://example.com "제목")
[같은 문서의 제목](#제목-2)
[[문서#제목|별칭]]
![[문서#제목]]

- 링크는 웹(http·https)·메일 주소, 문서 안
#제목, 다른 마크다운 문서,[[…]]를 클릭해 엽니다. 그 밖의 주소는 열지 않습니다. ![[문서]]는 한 줄에 혼자 쓰면 그 문서(또는#제목부분)를 펼쳐 보여 줍니다. 문서 폴더 안 마크다운만 되고 4단계, 한 문서에 64개까지입니다. 도구 > 설정 > 미리보기의 「임베드 ![[문서]] 펼치기」로 끕니다.- 그림은 문서 폴더 안의 파일만 보입니다.
확장 문법
| 문법 | 보이는 모양 |
|---|---|
==형광== |
형광펜 |
++밑줄++ |
밑줄 |
H~2~O · 9m^2^ |
아래첨자 · 위첨자(안에 공백 없음, ~~는 취소선) |
#태그 |
태그 칩 |
%%주석%% |
숨김(%% 한 줄로 감싸면 여러 줄) |
문장 ^블록-id |
문단 끝 블록 참조(흐리게) |
## 제목 {#아이디} |
제목 아이디 — [가기](#아이디)로 이동 |
{width=320} |
그림 크기 |
:smile: · :+1: · :) |
이모지(코드 안은 그대로) |
*[HTML]: Hyper Text Markup Language |
약어 정의 — 정의 줄은 숨고, 문서의 HTML에 점선 밑줄과 풀이 툴팁 |
<kbd>·<b>·<i>·<u>·<del>·<mark> |
해당 서식 |
<br> · <img src="a.png" width="32"> |
줄 바꿈 · 크기를 준 그림 |
언어 없이 첫 줄이 괘선(┌─┐)인 코드 블록과 ```boxtable·```boxtree는 줄 사이 틈 없이 그립니다.
::: note 제목
note · tip · warning · caution · details(접기) · columns(나란한 열)
:::
용어
: 뜻풀이
- 상자 안도 마크다운으로 그려지고, 모르는 이름은 테두리 상자입니다.
::: columns안에::: column상자를 두면 한 열씩 나란히 놓입니다. - details는 머리를 클릭해 접고 펴며 처음에는 접혀 있습니다. HTML
<details><summary>도 같은 상자로 그립니다.
주의: 웹 주소·폴더 밖·저장하지 않은 문서의 그림은 깨진 그림 표시로 나옵니다. 중첩이 지나치게 깊은 문서는 서식 없이 원문 그대로 보이고,
<script>·<style>안은 그리지 않습니다.
흔한 실수
- 제목 기호 뒤에 공백이 없음:
#제목→# 제목. - 들여쓰기를 탭과 공백으로 섞음 — 도구 > 문제 자동 수정(F7)이 고칩니다.