Markdown 语法速查表

Markdown 的语法不多,但总有那么几个记不住:表格怎么对齐、代码块怎么高亮、任务列表的方括号里写什么。本页把常用语法与 GitHub 扩展语法分别列成对照表,随查随用。

常用语法

效果写法说明
标题# H1 … ###### H6六级标题,# 后需空格
粗体**粗体**加粗文字
斜体*斜体*倾斜文字
粗斜体***两者***同时加粗倾斜
删除线~~删除线~~划掉的文字
无序列表- 项目圆点列表,可嵌套缩进
有序列表1. 项目自动编号列表
引用> 引用左侧竖线的引用块
行内代码`code`等宽字体的代码片段
代码块```语言带语言标注的高亮块
链接[文字](url)可点击的超链接
图片![说明](url)嵌入图片
分割线---一条水平分隔线

GitHub 扩展语法

语法写法说明
表格| 列 A | 列 B | | --- | --- | | 1 | 2 |分隔行决定对齐,见下方说明
任务列表- [x] 已完成 - [ ] 未完成方括号内加 x 表示勾选
自动链接https://example.com裸 URL 自动识别为链接
表格左对齐| :--- |分隔行左侧加冒号
表格居中| :---: |分隔行两侧都加冒号
表格右对齐| ---: |分隔行右侧加冒号

常见问题

Markdown 和富文本编辑器有什么区别?

核心区别是可读性与控制权。Markdown 是纯文本加轻量标记,即使不渲染也能直接读懂,可以用任何编辑器打开,天然适合版本控制——Git 能清晰地显示每一次改动的差异,而富文本的二进制或复杂格式几乎无法做代码审查。代价是排版自由度低,复杂的图文混排做不了。反过来富文本所见即所得,排版能力强,但内容与样式耦合,迁移和协作成本高。技术文档、README、博客草稿适合 Markdown;营销页、复杂排版的海报适合富文本。

Markdown 表格怎么设置列对齐?

靠表头下面那一行分隔线控制。分隔线默认左对齐;在左边加冒号写作 :--- 是左对齐;两边都加冒号 :---: 是居中;右边加冒号 ---: 是右对齐。冒号的位置直接对应列的对齐方向,这是最直观的记法。要注意的是,分隔行里至少要有一个连字符,多写几个也无所谓,但整行的列数必须与表头一致,否则表格不会被识别。

代码块怎么写才能高亮?

用三个反引号包裹,并在开头的反引号后面紧跟语言标识符,比如 ```python 或 ```javascript。这个标识符告诉渲染器用哪种语法规则上色,写错或漏写就只会渲染成普通的等宽文本块。如果代码里本身含有反引号,可以用更多个反引号包裹来解决,比如用四个反引号包住含三个反引号的内容。只写单个词或短表达式时用一对单反号做行内代码即可。

Markdown 能直接导出成 PDF 或 Word 吗?

Markdown 本身只是文本格式,没有导出能力,需要借助工具链。最常见的是先转成 HTML 再打印或转 PDF,静态站点生成器、编辑器插件和命令行工具都能完成这一步;转 Word 一般也要先转 HTML 或 DOCX 中间格式。实际差别主要在样式上:默认转换出来的 PDF 样式朴素,想要好看需要自定义 CSS。如果最终交付物必须是排版精美的 PDF,直接用排版工具可能比走 Markdown 更省事。