joplin 中文文档 下载 App

Markdown 表格写法对齐与插件增强

表格是 Markdown 里最"硬"的语法,写对了非常清爽,写错了整块渲染失败。这篇把它一次讲透。

基础写法

第一行是表头,第二行是分隔行(必不可少),之后每行一条数据:

| 姓名 | 用途 | 状态 |
| --- | --- | --- |
| 项目笔记 | 记录进度 | 进行中 |

渲染效果:

姓名用途状态
项目笔记记录进度进行中

列对齐

分隔行里的连字符位置决定对齐方式:

| 左对齐 | 居中 | 右对齐 |
| :--- | :---: | ---: |
| a | b | c |

容易踩的坑

  1. 分隔行不能少:少了它整段会被当作普通文字;
  2. 竖线要成对:每行开头和结尾都写竖线最保险;
  3. 单元格内不能换行:内容多先放一行,或者拆成列表;
  4. 源文本不必对齐:渲染器不在乎源文本里竖线是否上下对齐,编辑时可读性随意。

复杂表格怎么办

Markdown 原生不支持合并单元格这类操作。需要复杂表格时两条路:

让表格好打十倍的插件

官方插件库里的 Rich Markdown 与各类表格编辑插件能在源文本上提供表格列对齐显示、Tab 跳格等能力,重度表格用户值得装一个。插件安装方法见插件系统与热门推荐。

表格常与附件配合做资料归档:图文混排见附件管理。

语法支持范围可能随版本与插件变化,以官方最新版为准。