8 种常用Markdown语法
摘要
整理写作最常用的 8 种 Markdown 语法：标题（# 级数）、列表（无序 - 与有序 1.）、链接与图片（[文本](地址) 与 ）、引用（>）、行内代码（`）、代码高亮（```语言 代码块）、粗体（**）与斜体（*）、以及表格（| 分隔 + 对齐冒号）。配图例说明渲染效果，并提醒避免文章内用一级标题以利自动生成目录。
为什么你要会 Markdown？
如果你准备在这里（或任何一个技术博客 / 代码平台）写文章，那 Markdown 就是绕不开的基础功。它是一种"用纯文本就能表达排版"的标记语言：你看到的标题、加粗、列表、代码块、表格，本质都是几个符号拼出来的。好处是写起来快、不依赖编辑器、内容永远可迁移——今天在博客写，明天复制到 GitHub、公众号编辑器、语雀都基本通用。
这篇不教你背语法，而是站在"写一篇博客教程"的真实场景，把最常用的几招一次讲透。掌握了这些，排版一篇图文并茂的文章绰绰有余。
先知道一件事：Markdown 没有"官方标准"
这可能是最该提前告诉你的一句话，因为它能解释你后面遇到的绝大多数"为什么我这里能用、那里不行"。
Markdown 最初是 2004 年 John Gruber 设计的一套轻量规则，只有一份描述性文档，没有严格的形式规范。结果各家实现（叫"方言"）就自由发挥了。如今你实际会碰到的，主要是这么几套：
规范 / 方言 | 谁在用 | 特点 |
|---|---|---|
CommonMark | 很多现代编辑器、静态站生成器 | 有严格规范，专门用来终结"方言乱象" |
GFM（GitHub Flavored Markdown） | GitHub、绝大多数代码平台 | 在 CommonMark 上加表格、任务列表、删除线、自动链接 |
原版 Markdown | 老一些的博客引擎 | 没有表格，没有任务列表 |
各家自研方言 | 公众号编辑器、语雀、飞书文档 | 语法基本兼容，但渲染细节和扩展语法各不相同 |
所以第一件要接受的事：你掌握的应该是"CommonMark / GFM 这一套通用内核"，然后用的时候留个心眼——某个高级语法（比如表格、脚注）在目标平台可能不支持。最基础的四样（标题、列表、链接、代码块）几乎全平台通吃，这也是后面我建议你优先记住它们的原因。
一、标题：搭好文章骨架
标题是文章的骨架。语法很简单：# 加空格再加文字，# 越多，级别越低。
注意
#和文字之间的那个空格——它不是可选的。 大多数解析器要求#后面必须有空格（或行首#后直接结束），写成#标题在很多实现里不会被识别成标题，而是当作普通段落。这是新手最高频的"明明写对了却没生效"。
实际写作时的习惯建议：
#和标题文字之间保留一个空格，这是最标准的 Markdown 写法，也避免在某些平台被误判；文章的大标题请用二级标题
##起，因为多数博客系统（包括本站）会自动把文章标题渲染成"一级标题"，如果你内容里再用#，就会和文章标题撞车、显得层级混乱；多用二级、三级标题把内容切块，本站会自动生成目录（TOC），读者能一眼看清文章结构。
图例（渲染效果示意）：
二、列表：把要点排整齐
写步骤、列清单是博客的高频需求。无序列表在行首加 -，有序列表在行首加 数字.：
建议：步骤类的操作说明优先用有序列表，读者能顺着序号一步步来，不会乱。
图例：
三、链接和图片：让文章"有血有肉"
技术教程最离不开引用链接和配图。
插入链接的格式是 [显示文字](链接地址)：
插入图片的格式是 ——注意它和链接很像，只是前面多了一个 !。图片文字留空即可：
配图建议：把图片先传到图床拿到稳定的直链（本站有自带图床上传），不要贴本地路径，否则换设备或发到别处会裂图。
为什么"必须图床"这件事值得强调？ 因为本地相对路径（比如 ./images/a.png）只在你自己电脑上打开时才有效。一旦内容被传播出去——RSS 订阅、邮件推送、别人复制到别处——相对路径全部失效，读者看到的就是一片裂图。图床给你的是一个全球可访问的绝对 URL，这是内容能否"离开你的电脑还活着"的分界线。
图例：
四、引用：引用他人文字
要引用别人说过的话，或者做"注意事项"提示，在文字前加 > 即可：
渲染后是一段带竖线的"引用块"，很适合放备注、出处、警告。
图例：
五、行内代码与代码高亮
写技术教程，命令、函数名、文件路径这类"程序里的词"，用反引号包起来变成行内代码：
而整段代码，用三个反引号包裹，并在开头标注语言，就能得到带语法高亮的代码块：
Markdown 的 粗体 和 斜体 非常简单。
项目 | 价格 | 数量 |
|---|---|---|
iPhone | 6000 元 | 5 |
iPad | 3800 元 | 12 |
iMac | 10000 元 | 234 |
第二步……