Markdown 是什么?常用语法速查表与转 HTML 方法
Markdown 是一种用纯文本符号来标记排版格式的轻量级标记语言:用 # 表示标题、用 - 表示列表、用 ** 包住文字表示加粗,写的时候是纯文本,渲染后就成了带格式的网页。它上手快、跨平台、纯文本方便存档,常用来写笔记、文档和 README。想边写边看效果或导出网页,用 Markdown 转 HTML 能在浏览器本地实时预览并转成 HTML,内容不上传。
- Markdown 用纯文本符号标记格式:# 是标题、- 是列表、** 是加粗,写完再渲染成网页。
- 标题按 # 的个数分 1~6 级,井号和文字之间要留一个空格,否则不生效。
- 表格用 | 分列、第二行用 --- 定义分隔与对齐;代码用三个反引号围成代码块。
- 常见踩坑:段内换行要在行尾留两个空格,列表和正文之间最好空一行。
- Markdown 本身不是网页,要在浏览器里显示需先转成 HTML;本站转换在本地完成、不上传。
Markdown 是什么?和富文本编辑有什么区别
Markdown 是一套用纯文本符号来标记排版的轻量级语法:你在纯文本里写下约定好的符号,渲染器再把它变成带标题、列表、加粗、表格的网页。它由 John Gruber 在 2004 年提出,目标是「易读易写」——即使不渲染,源码本身也接近排好版的样子。
一句话定义:Markdown 用#、-、**这类普通字符标记格式,写的是纯文本,看的是渲染后的网页,两者由一个转换器连接。
为什么不直接用 Word 这类富文本
富文本编辑器是「所见即所得」,格式被藏在文件内部的样式数据里,换个软件打开常常走样,也不好做版本对比。Markdown 反过来:格式就写在明处、体积极小、任何文本编辑器都能读,天然适合用 Git 管理版本。代价是你要渲染之后才看到最终效果,复杂排版也不如富文本灵活。所以它最适合写笔记、技术文档、README、博客这类以文字为主的内容。
Markdown 有哪些常见「方言」
最初的 Markdown 只定义了标题、列表、链接等基础语法。后来出现了 CommonMark(把模糊之处标准化)和 GitHub Flavored Markdown(GFM,加了表格、任务列表、删除线、自动链接)。今天大多数平台支持的其实是 GFM,本文的表格、代码块示例也按 GFM 来讲。
Markdown 常用语法速查表(标题列表加粗)
新手只要记住下面这张速查表,就能覆盖八成日常写作。规律是「行首符号 + 一个空格」控制块级格式(标题、列表、引用),「成对符号」控制行内格式(加粗、斜体、代码)。
| 你想要的效果 | Markdown 写法 | 要点 |
|---|---|---|
| 一级 / 二级标题 | # 标题 / ## 标题 | 井号后要留一个空格,最多六级 |
| 加粗 | **加粗** | 两个星号,符号贴着文字 |
| 斜体 | *斜体* 或 _斜体_ | 一个星号或下划线 |
| 无序列表 | - 条目 | 减号后留空格,可用 * 或 + |
| 有序列表 | 1. 条目 | 数字加点,序号会自动排 |
| 链接 | [文字](网址) | 方括号写显示文字 |
| 图片 |  | 比链接多一个开头的 ! |
| 引用 | > 引用文字 | 大于号后留空格 |
| 行内代码 | 用反引号包住 代码 | 适合短命令、变量名 |
| 分割线 | --- | 单独一行三个减号 |
列表还能嵌套吗
可以。在子项前面缩进两个(或四个)空格,就能把列表套进上一级里,形成多层大纲。有序和无序列表可以混套,例如一级用 1.、下一级缩进后用 -。缩进不一致是嵌套失败最常见的原因,建议统一用两个空格。
Markdown 表格和代码块怎么写
表格和代码块是 GFM 里最常用、也最容易写错的两块。表格靠竖线 | 分列、第二行用 --- 定义表头分隔与对齐;代码块用三个反引号围起来。
表格:竖线分列 + 分隔行
一个最小表格长这样(源码里不必对齐,渲染时自动对齐):
| 姓名 | 分数 || --- | ---: || 小鹿 | 98 |
第一行是表头,第二行是必需的分隔行,用 --- 表示每一列,两端加冒号控制对齐::--- 左对齐、:---: 居中、---: 右对齐。分隔行的列数必须和表头相同,否则整块不会被当成表格。
代码块:三个反引号围栏
把代码放进单独的区块,用三个反引号另起一行开始、再用三个反引号另起一行结束,中间的内容会原样保留、不做 Markdown 解析。开头的反引号后面还能写语言名(如 js、python)来提示语法高亮。行内的短代码则用一对单反引号包住即可。
任务列表怎么打勾
GFM 支持任务清单:在列表项的 - 后面写 [ ] 是未完成、写 [x] 是已完成,渲染出来就是可视的复选框,很适合写待办和检查清单。
Markdown 写出来格式不对是什么原因
新手遇到「符号没生效、格式乱掉」,九成是踩了下面这几个坑。对照这张踩坑清单排查,比逐字找错快得多。
Markdown 新手最常见的 5 个踩坑
- 符号后忘了空格:
#标题、-条目都不生效,井号、减号、大于号后面都要跟一个空格。 - 换行没留两个空格:段内敲一次回车会被当成空格粘在一起,行尾留两个空格或空一行才会真正换行。
- 列表和正文没空行:列表紧贴上一段文字时可能不被识别,块与块之间空一行最稳。
- 表格缺分隔行或列数不符:表头下必须有
---分隔行,且列数与表头一致,否则退化成普通文本。 - 星号被误当格式:想显示普通星号或下划线,在符号前加反斜杠
\转义,例如\*就会显示成星号本身。
不同平台渲染不一样正常吗
正常。由于存在 CommonMark、GFM 等不同规范,同一段 Markdown 在不同平台的细节(如单换行、HTML 内嵌、脚注支持)可能略有差异。想确认自己写的到底会渲染成什么样,最直接的办法是丢进一个渲染器实时预览,别只靠脑补。
Markdown 怎么实时预览并转成 HTML 网页
Markdown 本身不是网页,浏览器不会直接把 # 显示成标题——必须先经过一个转换器把它变成 HTML,浏览器才认得。所以「预览效果」和「转成网页」本质是同一件事:把 Markdown 渲染成 HTML。
实时预览:边写边看效果
把 Markdown 粘进 Markdown 转 HTML 工具,右侧会即时显示渲染后的样子,改一处看一处,特别适合边学语法边验证。它默认开启 GFM,表格、代码块、任务列表都能正确渲染,也能选择把单换行转成 <br>。
导出 HTML:片段还是整页
确认效果后有两种拿走方式:只复制 body 里的 HTML 源码,方便嵌进已有网页;或勾选「导出完整 HTML 文档」,下载带 <head>、UTF-8 声明和基础样式的 .html 文件,双击就能用浏览器打开。带了 charset 声明,中文和 emoji 都不会乱码。整个渲染在你的浏览器本地完成、内容不上传,输出还会经 DOMPurify 消毒去除脚本,预览也跑在沙箱里,安全防 XSS。
转好的 HTML 能再改吗
能。导出的 HTML 是标准网页代码,可以用任意编辑器继续调整样式或结构。如果你想反过来把网页内容整理回 Markdown,那属于另一个方向的转换,思路和本工具相反,这里不展开。日常「写文档 → 出网页」用 Markdown 转 HTML 一步到位即可。
常见问题
- Markdown 里怎么打出加粗和斜体文字
- 加粗用两个星号把文字包起来,写 **加粗** 就会渲染成加粗;斜体用一个星号或一个下划线,写 *斜体* 或 _斜体_。两者可以叠加,***这样*** 就是又粗又斜。注意星号和文字之间不要留空格,写成 ** 加粗 ** 反而不生效。
- Markdown 的标题用几个井号表示
- 标题用行首的井号 # 表示,一个 # 是一级标题(相当于网页 H1),两个 ## 是二级,最多到六个 ###### 六级。关键是井号和标题文字之间必须留一个空格,写 #标题 不会生效、要写 # 标题。一篇文档通常只用一个一级标题,其余按层级往下排。
- Markdown 怎么插入图片和超链接
- 链接写成 [显示文字](网址),例如 [小鹿tools](https://example.com);图片在前面多加一个感叹号,写成 。区别就是图片比链接多一个开头的 ! 号,替代文字在图片加载失败时显示,也方便无障碍阅读。
- Markdown 表格竖线不对齐是什么原因
- 源码里的竖线 | 不需要用空格手动对齐,渲染时会自动对齐,看起来错位是正常的。真正要注意的是:表头下面必须有一行用 --- 组成的分隔行,且分隔行的列数要和表头一致,少一列整张表就不会被识别成表格。想控制对齐可在 --- 两端加冒号,:--- 左对齐、:---: 居中、---: 右对齐。
- Markdown 换行没生效怎么办
- Markdown 里直接敲一次回车通常不会换行,只会被当成同一段落里的空格。要在段内强制换行,在行尾留两个空格再回车,或直接空一行另起新段落。写列表、引用时同理,项与项之间、列表与正文之间空一行最稳,能避免粘连成一坨。
- Markdown 文件用什么打开和编辑
- Markdown 文件后缀是 .md 或 .markdown,本质是纯文本,用任意文本编辑器(记事本、VS Code)都能打开编辑。想边写边看渲染效果,可用带预览的编辑器,或直接把内容粘进在线的 Markdown 转 HTML 工具,在浏览器里实时预览、无需装软件。
- Markdown 转 HTML 后中文会乱码吗
- 不会乱码,前提是导出的 HTML 文件带 UTF-8 编码声明。用本站的 Markdown 转 HTML 导出「完整 HTML 文档」时会自动写入 charset=utf-8,中文和 emoji 都能正常显示;若只复制 body 片段嵌进别的页面,要确保那个页面本身也是 UTF-8 编码。
- Markdown 和富文本编辑器有什么不同
- 富文本编辑器(如 Word)是所见即所得,格式以隐藏的样式信息存在文件里,跨软件容易走样;Markdown 是纯文本 + 少量符号,格式一眼可见、体积小、任何编辑器都能读,还方便用 Git 做版本管理。代价是它要渲染后才能看到最终效果,且复杂排版能力不如富文本。
记住「符号 + 空格」的规律,Markdown 十分钟就能上手。想边写边确认效果,把内容粘进 Markdown 转 HTML 就能实时预览渲染结果,确认无误后复制 HTML 源码或一键下载成 .html 网页文件;全程在浏览器本地完成、内容不上传,中文不乱码。
参考资料
延伸阅读
本文由「小鹿tools」整理,更新于 2026-08。如发现信息过期或有误,欢迎反馈。