为什么专门写一个 Markdown 技巧系列

日常写 Markdown 时,最容易卡住的几件事是:

  • 表格里的数字明明想右对齐,渲染出来却全是左对齐;
  • 想在文档里画个流程图,又不想专门开一个画图软件;
  • 代码块没有语法高亮,看起来像一坨纯文本;
  • 公式只能截图贴进去,改一个符号就得重截。

这些其实都有现成的标准写法。下面这 12 篇文章,就是把这些「写文档时真正会用到的进阶技巧」整理成一个完整系列。每篇都尽量做到:先讲清语法,再给一段可以复制即用的示例;记不住语法的时候,还会顺带讲用 mdview 一键插入的省事做法。

12 篇文章一览

主题一句话定位难度
表格表头左/中/右对齐、列宽与复杂表格入门
Mermaid 图表流程图、时序图、甘特图,纯文本画图进阶
代码块围栏代码、语言标注、语法高亮入门
链接与图片超链接、参考式、图片与锚点跳转入门
内置编辑器快捷键mdview 按 F3 进入编辑器的高效用法入门
数学公式用 KaTeX / LaTeX 写行内与块级公式进阶
添加表格三行一组语法 + mdview 一键插入入门
表格加列逐行补格子 + mdview 鼠标加列入门
表格加行照抄一行改内容 + mdview 右键加行入门
删行删列逐行砍格子 + mdview 选中即删入门
表头对齐分隔行冒号 + 表头单独对齐入门
内容对齐数字右对齐、文字左对齐的惯例入门

① 表格 —— 对齐、列宽与复杂表格

表格是 Markdown 里最容易「写得出、却对不齐」的元素。这一篇讲清楚表头怎么左对齐、居中、右对齐(用 :---、:---:、---:),列太宽怎么办,以及什么时候该直接上 HTML <table> 兜底。

详细教程见:Markdown 表格完全指南:对齐、列宽与复杂表格。

② Mermaid 图表 —— 纯文本画流程图、时序图、甘特图

不需要打开任何画图软件,在 Markdown 里写几行 ```mermaid 代码,就能渲染出流程图、时序图、甘特图。mdview 还支持双击图表放大查看,宽图也不怕看不清。

详细教程见:用 Mermaid 在 Markdown 里画图:流程图、时序图、甘特图。

③ 代码块 —— 围栏、语言标注与语法高亮

三个反引号 ``` 包起来就是代码块,标注语言就能语法高亮。这一篇讲围栏代码、行内代码、语言标注,以及怎么在代码里转义反引号本身。

详细教程见:代码块与语法高亮:围栏、语言标注与转义。

④ 链接与图片 —— 超链接、参考式与锚点跳转

从最基本的 [文字](网址),到更清爽的参考式链接、图片语法,再到文档内锚点跳转(点目录跳到对应章节),这一篇一次讲完。

详细教程见:链接、图片与锚点:超链接、参考式与跳转。

⑤ mdview 内置编辑器快捷键 —— F2 就地编辑 / F3 分屏编辑

mdview 不只是「看」Markdown,按 F2 就地编辑(点哪段改哪段、所见即所得),按 F3 进入分屏编辑(左边写源码、右边实时预览)。这一篇整理两种模式的全部快捷键——Ctrl+S 保存、Ctrl+T 插表格、输入 table 按 Tab 一键补全,等等。

详细教程见:mdview 编辑器快捷键速查(F2 就地编辑 / F3 分屏编辑)。

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

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

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

⑦ 添加表格 —— 手写三行一组,记不住就让工具替你记

从零插一张表:表头行、分隔行、数据行三行一组。这一篇先讲标准语法和全角符号、漏分隔行这些常见坑,再讲 mdview 里的偷懒做法——按 F3 输入 table 按 Tab 生成模板;或按 F2 输入 / 选「表格」(输 /table3x4 还能直接出指定尺寸)、点工具栏表格图标像在 Word 里一样插入,再点着格子填内容。

详细教程见:Markdown 里怎样添加一个表格?手写语法与一键插入两种方法。

⑧ 表格加列 —— 每行同位置补一格,或者鼠标点一下

表格建好想加一列:手改源码得给表头、分隔行和每个数据行的同一位置各补一格,漏一行整表就错位散架。mdview 按 F2 就地编辑,鼠标移到表格边缘,右键「在左侧 / 右侧新增列」或点 ➕ 追加,插列、删列、拖动、排序全在鼠标边上。

详细教程见:Markdown 表格里怎样添加一列?手改源码与一键加列两种方法。

⑨ 表格加行 —— 照抄一行改内容,或者右键一下

表格想加一行数据:手改源码最稳妥的做法是照抄一行现成的再改内容,注意列数别抄多抄少、表格中间不能留空行、内容里的竖线要转义。mdview 按 F2 就地编辑,鼠标移到表格左边缘,右键「在上方 / 下方新增行」「复制行」,在最后一格按 Tab 还能自动追加一行。

详细教程见:Markdown 表格里怎样添加一行?手改源码与一键加行两种方法。

⑩ 删行删列 —— 删行删整行文本,删列每行砍一格

删一行就是把那一行文本整行删掉(千万别误删分隔行,删掉它整表散架);删一列和加一列一样繁琐,得给每一行的同一位置各删一格。mdview 按 F2 就地编辑,鼠标移到表格边缘选中行或列,按 Delete 即删,右键菜单里也有「删除行」「删除列」,删错了 Ctrl + Z 可撤销。

详细教程见:Markdown 表格怎样删除一行或一列?手改源码与一键删除两种方法。

⑪ 表头对齐 —— 分隔行冒号,或表头单独设

表头居中 / 靠左 / 靠右的开关在分隔行的冒号上(:---、:---:、---:),一列的表头和内容一起动。「表头居中、内容左对齐」这种各动各的,标准语法做不到——mdview 支持表头独立对齐,按 F2 右键列菜单「表头居中」点一下即可,源码自动写好。

详细教程见:Markdown 表头怎样设置居中、靠左、靠右?分隔行冒号与表头单独对齐。

⑫ 内容对齐 —— 数字右对齐、文字左对齐、短标签居中

表格每列内容的对齐同样由分隔行冒号决定,按列生效。照 Excel、财务报表的惯例来:文字列左对齐、数字列右对齐(小数点上下对齐才好比大小)、状态日期居中。mdview 按 F2 右键列菜单「内容左对齐 / 内容居中 / 内容右对齐」一键切换,不用记冒号在左还是在右。

详细教程见:Markdown 表格内容怎样设置居中、靠左、靠右?分隔行冒号一次说清。

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

系列文章(12 篇已发布)

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

  1. Markdown 表格完全指南:对齐、列宽与复杂表格
  2. 用 Mermaid 在 Markdown 里画图:流程图、时序图、甘特图
  3. 代码块与语法高亮:围栏、语言标注与转义
  4. 链接、图片与锚点:超链接、参考式与跳转
  5. mdview 编辑器快捷键速查(F2 就地编辑 / F3 分屏编辑)
  6. 在 Markdown 里写数学公式:KaTeX / LaTeX 入门
  7. Markdown 里怎样添加一个表格?手写语法与一键插入两种方法
  8. Markdown 表格里怎样添加一列?手改源码与一键加列两种方法
  9. Markdown 表格里怎样添加一行?手改源码与一键加行两种方法
  10. Markdown 表格怎样删除一行或一列?手改源码与一键删除两种方法
  11. Markdown 表头怎样设置居中、靠左、靠右?分隔行冒号与表头单独对齐
  12. Markdown 表格内容怎样设置居中、靠左、靠右?分隔行冒号一次说清

想立刻试一试这些语法?用 mdview 打开任意 .md 文件,按 F2 就地改两笔、按 F3 进入分屏编辑,边写边看预览。