Markdown 문법 치트시트

渲染为加粗文字

굵게, 별표 두 개 또는 밑줄 두 개

渲染为斜体文字

기울임, 별표 하나 또는 밑줄 하나

渲染为加粗且斜体

굵은 기울임

文字中间加一条删除线

취소선, CommonMark에는 없는 GFM 확장

灰底等宽文字

인라인 코드, 백틱 하나로 감쌈

嵌套行内样式

인라인 스타일 중첩 가능, 밑줄 표기가 덜 헷갈림

주의: 별표 안쪽 공백은 문법을 깨뜨림

一条水平分割线

구분선, 하이픈 3개 이상(별표나 밑줄도 가능)

주의: 텍스트 바로 아래에 쓰면 Setext 제목으로 해석됨, 위에 빈 줄 필요

显示为字面星号

백슬래시 이스케이프, 다음 문자를 그대로 표시

주의: 이스케이프 가능한 문자는 정해진 ASCII 문장부호뿐

强制换行，不产生新段落

줄 끝 공백 두 개로 강제 줄바꿈

주의: 공백은 보이지 않아 포매터가 지우기 쉬움, 줄 끝 백슬래시가 더 안전

强制换行，效果同上但可见

줄 끝 백슬래시로 강제 줄바꿈, 공백보다 명확

插入一个不折行空格

HTML 엔티티는 그대로 유지됨

渲染后不显示

주석, 렌더링 결과에 나타나지 않음

最大的标题

1~6단계 제목, 샵 뒤에 공백 필수

주의: 공백이 없으면 대부분의 파서가 무시

最小的标题

6단계 제목, 7개 이상은 그대로 표시

上一行变成一级标题

Setext 방식, 등호로 윗줄을 1단계 제목으로

上一行变成二级标题

Setext 방식, 하이픈으로 2단계 제목

给标题指定锚点 id

사용자 정의 앵커 id, 표준 Markdown은 아님

주의: GitHub는 소문자화와 하이픈으로 앵커 생성, 비ASCII는 제거

带序号的一项

순서 있는 목록, 숫자와 마침표, 공백

带序号的一项

다른 순서 목록 표기, 일부 파서 미지원

缩进的子列表

중첩 목록, 하위 항목을 2~4칸 들여쓰기

주의: 들여쓰기가 부족하면 같은 레벨, 과하면 코드 블록

带空复选框的一项

작업 목록 미완료(GFM 확장)

带勾选复选框的一项

작업 목록 완료, x는 대소문자 무관

同一项里的第二个段落

한 항목의 여러 문단, 이어지는 문단은 항목 텍스트와 정렬

列表项里的代码块

목록 항목 안의 코드 블록은 목록 내용에 맞춰 들여쓰기

序号从三开始且后续递增

시작 숫자는 반영되고 이후 번호는 자동 증가

表头行

첫 행이 헤더

分隔行，必须有

구분 행이 없으면 표로 렌더링되지 않음

주의: 구분 행의 열 수가 헤더와 맞아야 하며 아니면 잘림

左对齐与右对齐

콜론 위치로 정렬: 왼쪽, 오른쪽

居中对齐

양쪽 콜론은 가운데 정렬

显示为竖线字符

셀 안에 파이프를 표시하려면 이스케이프 필요

单元格内换行

셀 안 줄바꿈은 HTML br 사용

带语法高亮的代码块

펜스 코드 블록, 언어를 쓰면 구문 강조

주의: 언어를 생략하면 대개 강조 없음

波浪号围栏代码块

물결표 펜스, 내용에 백틱이 있을 때 유용

缩进式代码块

들여쓰기 코드 블록, 구식 표기

内层含反引号的行内代码

내용에 백틱이 있으면 더 많은 백틱으로 감쌈

一个超链接

인라인 링크

带悬停标题的链接

링크에 제목을 붙이면 마우스 오버 시 표시

自动识别为链接

꺾쇠로 감싼 URL은 자동 링크

引用式链接

참조형 링크, 긴 URL을 문서 끝에 모음

一张图片

이미지 문법은 링크에 느낌표를 붙인 형태

주의: 대체 텍스트는 생략하지 않음, 이미지 실패 시 유일한 단서

点击图片跳转

이미지를 링크로 감싼 형태

跳到页内某处

페이지 내 이동, 앵커 규칙은 렌더러에 따름

跳到相对路径文件

상대 경로 링크, 플랫폼이 지원할 때만 클릭 가능

显示为字面方括号

링크 텍스트에 대괄호가 있으면 이스케이프

左侧带竖线的段落

인용문, 꺾쇠 뒤에 공백 권장

两级缩进的引用

중첩 인용, 단계마다 꺾쇠 추가

引用里的第二个段落

인용문 안 빈 줄에도 꺾쇠가 필요, 없으면 인용이 끊김

引用里的代码块

인용문 안 코드 블록은 모든 줄에 꺾쇠 필요

带强调的提示块

인용문 안에 강조와 인라인 문법 사용 가능

带图标的提示块

GitHub 경고 블록, TIP·IMPORTANT·WARNING·CAUTION도 있음

주의: GitHub 계열에서만 동작, 다른 곳에서는 일반 인용으로 표시

脚注标记

각주 참조, 문서 끝에 정의 작성

脚注定义

각주 정의, 이름은 임의 식별자 가능

渲染为一个表情

이모지 단축 코드, 플랫폼 이모지 표에 의존

行内数学公式

인라인 수식, MathJax나 KaTeX 필요

주의: 대부분 플랫폼은 수식 렌더링이 꺼져 있어 그대로 표시

独立成行的公式

블록 수식, 렌더러 의존

渲染成图表

Mermaid 다이어그램, 플랫폼 지원 필요

渲染为目录

자동 목차, GitLab과 일부 위키 지원

주의: GitHub는 미지원, 그대로 표시됨

渲染为可点击的引用

이슈 참조와 멘션은 플랫폼 기능, Markdown 표준 아님

强制换行

Markdown 안에 HTML 직접 작성 가능, 대부분 허용

可折叠区块

접이식 블록, 긴 로그에 유용

주의: GitHub는 렌더링하지만 내부 Markdown은 빈 줄이 있어야 파싱

指定宽度的图片

HTML 이미지에 width 등 속성 지정 가능

键帽样式

키보드 키 스타일, 문서 작성에 흔함

两种粗体写法都生效

인라인 HTML과 Markdown 혼용 가능

주의: 블록 HTML 앞뒤에 빈 줄이 없으면 내부 Markdown 파싱 중단