为什么专门写一个 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 插表格、输入 tableTab 一键补全,等等。

详细教程见:mdview 内置编辑器(F3)快捷键速查

⑥ 数学公式 —— 用 KaTeX / LaTeX 写公式

写技术文档、笔记时经常要写公式。Markdown 里用 $...$ 写行内公式、$$...$$ 写块级公式,分数、求和、矩阵都能漂亮地渲染出来,再也不用截图。

详细教程见:在 Markdown 里写数学公式:KaTeX / LaTeX 入门

阅读建议:如果你刚开始用 Markdown,建议按上面 ① → ⑥ 的顺序读;如果只想解决某个具体问题(比如表格对不齐),直接点进对应那篇即可。每篇都独立成文,带可复制的示例。

系列文章(6 篇已发布)

下面是本系列已完成的 6 篇教程,按建议阅读顺序排列:

  1. Markdown 表格完全指南:对齐、列宽与复杂表格
  2. 用 Mermaid 在 Markdown 里画图:流程图、时序图、甘特图
  3. 代码块与语法高亮:围栏、语言标注与转义
  4. 链接、图片与锚点:超链接、参考式与跳转
  5. mdview 内置编辑器(F3)快捷键速查
  6. 在 Markdown 里写数学公式:KaTeX / LaTeX 入门

想立刻试一试这些语法?用 mdview 打开任意 .md 文件,按 F3 进入内置编辑器,边写边看预览。