为什么专门写一个 Markdown 技巧系列
日常写 Markdown 时,最容易卡住的几件事是:
- 表格里的数字明明想右对齐,渲染出来却全是左对齐;
- 想在文档里画个流程图,又不想专门开一个画图软件;
- 代码块没有语法高亮,看起来像一坨纯文本;
- 公式只能截图贴进去,改一个符号就得重截。
这些其实都有现成的标准写法。下面这 6 篇文章,就是把这些「写文档时真正会用到的进阶技巧」整理成一个完整系列。每篇都尽量做到:先讲清语法,再给一段可以复制即用的示例。
6 篇文章一览
| 主题 | 一句话定位 | 难度 |
|---|---|---|
| 表格 | 表头左/中/右对齐、列宽与复杂表格 | 入门 |
| Mermaid 图表 | 流程图、时序图、甘特图,纯文本画图 | 进阶 |
| 代码块 | 围栏代码、语言标注、语法高亮 | 入门 |
| 链接与图片 | 超链接、参考式、图片与锚点跳转 | 入门 |
| 内置编辑器快捷键 | mdview 按 F3 进入编辑器的高效用法 | 入门 |
| 数学公式 | 用 KaTeX / LaTeX 写行内与块级公式 | 进阶 |
① 表格 —— 对齐、列宽与复杂表格
表格是 Markdown 里最容易「写得出、却对不齐」的元素。这一篇讲清楚表头怎么左对齐、居中、右对齐(用 :---、:---:、---:),列太宽怎么办,以及什么时候该直接上 HTML <table> 兜底。
详细教程见:Markdown 表格完全指南:对齐、列宽与复杂表格。
② Mermaid 图表 —— 纯文本画流程图、时序图、甘特图
不需要打开任何画图软件,在 Markdown 里写几行 ```mermaid 代码,就能渲染出流程图、时序图、甘特图。mdview 还支持双击图表放大查看,宽图也不怕看不清。
详细教程见:用 Mermaid 在 Markdown 里画图:流程图、时序图、甘特图。
③ 代码块 —— 围栏、语言标注与语法高亮
三个反引号 ``` 包起来就是代码块,标注语言就能语法高亮。这一篇讲围栏代码、行内代码、语言标注,以及怎么在代码里转义反引号本身。
详细教程见:代码块与语法高亮:围栏、语言标注与转义。
④ 链接与图片 —— 超链接、参考式与锚点跳转
从最基本的 [文字](网址),到更清爽的参考式链接、图片语法,再到文档内锚点跳转(点目录跳到对应章节),这一篇一次讲完。
详细教程见:链接、图片与锚点:超链接、参考式与跳转。
⑤ mdview 内置编辑器快捷键 —— 按 F3 进入的高效写法
mdview 不只是「看」Markdown,按 F3 就能进入左右分屏的内置编辑器:左边写源码、右边实时预览。这一篇整理它的全部快捷键——Ctrl+S 保存、Ctrl+T 插表格、输入 table 按 Tab 一键补全,等等。
详细教程见:mdview 内置编辑器(F3)快捷键速查。
⑥ 数学公式 —— 用 KaTeX / LaTeX 写公式
写技术文档、笔记时经常要写公式。Markdown 里用 $...$ 写行内公式、$$...$$ 写块级公式,分数、求和、矩阵都能漂亮地渲染出来,再也不用截图。
详细教程见:在 Markdown 里写数学公式:KaTeX / LaTeX 入门。
阅读建议:如果你刚开始用 Markdown,建议按上面 ① → ⑥ 的顺序读;如果只想解决某个具体问题(比如表格对不齐),直接点进对应那篇即可。每篇都独立成文,带可复制的示例。
系列文章(6 篇已发布)
下面是本系列已完成的 6 篇教程,按建议阅读顺序排列:
- Markdown 表格完全指南:对齐、列宽与复杂表格
- 用 Mermaid 在 Markdown 里画图:流程图、时序图、甘特图
- 代码块与语法高亮:围栏、语言标注与转义
- 链接、图片与锚点:超链接、参考式与跳转
- mdview 内置编辑器(F3)快捷键速查
- 在 Markdown 里写数学公式:KaTeX / LaTeX 入门
想立刻试一试这些语法?用 mdview 打开任意 .md 文件,按 F3 进入内置编辑器,边写边看预览。