为什么专门写一个 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 篇教程,按建议阅读顺序排列:
- Markdown 表格完全指南:对齐、列宽与复杂表格
- 用 Mermaid 在 Markdown 里画图:流程图、时序图、甘特图
- 代码块与语法高亮:围栏、语言标注与转义
- 链接、图片与锚点:超链接、参考式与跳转
- mdview 编辑器快捷键速查(F2 就地编辑 / F3 分屏编辑)
- 在 Markdown 里写数学公式:KaTeX / LaTeX 入门
- Markdown 里怎样添加一个表格?手写语法与一键插入两种方法
- Markdown 表格里怎样添加一列?手改源码与一键加列两种方法
- Markdown 表格里怎样添加一行?手改源码与一键加行两种方法
- Markdown 表格怎样删除一行或一列?手改源码与一键删除两种方法
- Markdown 表头怎样设置居中、靠左、靠右?分隔行冒号与表头单独对齐
- Markdown 表格内容怎样设置居中、靠左、靠右?分隔行冒号一次说清
想立刻试一试这些语法?用 mdview 打开任意 .md 文件,按 F2 就地改两笔、按 F3 进入分屏编辑,边写边看预览。