본문으로 건너뛰기
목차 · 설정과 참조

마크다운 문법 요약

미리보기가 그리는 마크다운 요소와 쓰는 법을 표로 정리합니다. 표준(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)
[[문서#제목|별칭]]
![[문서#제목]]
![대체 텍스트](그림.png)
  • 링크는 웹(http·https)·메일 주소, 문서 안 #제목, 다른 마크다운 문서, [[…]]를 클릭해 엽니다. 그 밖의 주소는 열지 않습니다.
  • ![[문서]]는 한 줄에 혼자 쓰면 그 문서(또는 #제목 부분)를 펼쳐 보여 줍니다. 문서 폴더 안 마크다운만 되고 4단계, 한 문서에 64개까지입니다. 도구 > 설정 > 미리보기의 「임베드 ![[문서]] 펼치기」로 끕니다.
  • 그림은 문서 폴더 안의 파일만 보입니다.

확장 문법

문법 보이는 모양
==형광== 형광펜
++밑줄++ 밑줄
H~2~O · 9m^2^ 아래첨자 · 위첨자(안에 공백 없음, ~~는 취소선)
#태그 태그 칩
%%주석%% 숨김(%% 한 줄로 감싸면 여러 줄)
문장 ^블록-id 문단 끝 블록 참조(흐리게)
## 제목 {#아이디} 제목 아이디 — [가기](#아이디)로 이동
![그림](a.png){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)이 고칩니다.

관련 페이지