手写语法:一个表格就是「三行一组」

Markdown 的表格不需要任何标记声明,直接写三行文本就是一张表:

  • 第一行是表头:每列的标题,用竖线 | 隔开;
  • 第二行是分隔行:每列写至少三个连字符 ---,它告诉渲染器「上面是表头,下面是数据」;
  • 第三行往后是数据行:一行就是表格里的一行,同样用竖线分列。

一个可以直接复制去用的例子:

| 姓名 | 部门 | 入职年份 |
| --- | --- | --- |
| 小明 | 研发 | 2023 |
| 小红 | 设计 | 2024 |

渲染出来就是这样一张普通的表格:

姓名部门入职年份
小明研发2023
小红设计2024

想多一行就再抄一行 | … | … | … |;想多一列,就在所有行(包括分隔行)的同一位置多写一格——这是另一篇要专门讲的事,见文末延伸阅读。

想让某一列居中或右对齐,在分隔行的对应列加冒号::--- 左对齐、:---: 居中、---: 右对齐。这部分细节(列宽、合并单元格等)在表格完全指南里讲得很全,这里不展开。

手写最容易踩的三个坑:①竖线和连字符必须是半角英文符号,从中文输入法或别的文档复制过来变成全角(|、—),表格直接渲染失败;②分隔行漏写,三行变两行,整段会被当成普通文字;③某一行少写了一个竖线,那一行的内容会挤到别的列里去。写完扫一眼每行的竖线数是否一致,能避开大部分问题。

太复杂了,我记不住,怎么办?

说实话,这套语法不难,难在低频。表格不是天天写,隔上两三个月,竖线几个、连字符几个、冒号加在哪边,基本就忘干净了——你可能就是搜着这个问题进来的。与其每次都搜一遍,不如让工具替你记。mdview 是一款支持 Windows、macOS、Linux、Android 的 Markdown 阅读器,内置了两种编辑模式,都能把「背语法」这件事省掉。

按 F3 分屏编辑:输入 table,按 Tab,表格模板直接生成

用 mdview 打开 .md 文件,按 F3 进入分屏编辑:左边是源码,右边是实时预览。在左边输入 table 再按 Tab,编辑器会自动展开成一个完整的表格模板——表头、分隔行、示例单元格全部就位,光标停在第一个待填的位置,你只管往里填字:

| 标题 | 标题 |
| --- | --- |
| 内容 | 内容 |

不想用补全的话,按 Ctrl + T 也能直接插入表格片段。填一格看一眼右边,表格长什么样全程心里有数,写完不用切窗口验证。

按 F2 就地编辑:输入 / 一键插表,点着格子填

更省事的玩法是按 F2 进入就地编辑。页面还是渲染好的样子,但已经可以像在 Word、Excel 里那样直接操作。想插一张新表,有两个入口:

  • 斜杠命令:在一个空行输入 /,会弹出一条命令面板;接着输入 table,面板里选中「表格」,回车——表头、分隔行齐备的表格就插进来了,第一个格子已经替你选中,只管打字。想直接指定大小,输 /table3x4 再回车,插出来的就是一张 3×4 的表(行数含表头,最大 20×20),省得插完再加减行列;
  • 工具栏按钮:窗口上方悬浮的格式工具栏里,有一个田字形的表格图标,点它一下,就像在 Word 里点「插入表格」一样,表格直接落在光标处(对应快捷键 Ctrl + T)。

插出来的表格,点任意一个单元格就能直接在里面打字,体验和 Excel 差不多:

  • Tab 跳到下一个单元格(自动全选,直接输入就覆盖),Shift + Tab 反向跳回;
  • 在最后一格按 Tab,自动新增一行,适合一行一行往下录数据;
  • 鼠标移到表格上,还有行列悬浮工具:加行、加列、移动、删除、对齐都在鼠标边上,全程不用碰源码。

两种模式都自动保存——停笔一秒左右就静默写入文件,改错了 Ctrl + Z 能撤销。顺手插一张表、改两笔用 F2,大段写内容用 F3,两者按 F2 / F3 可直接互切,再按一次或按 Esc 就退出,回到纯阅读。

小结

你的情况推荐做法
语法记得住,想精确控制手写三行一组,扫一眼竖线数
记不住语法,要写一整张表mdview 按 F3,输入 table 按 Tab 生成模板
只想点一点,插表加填内容mdview 按 F2,输入 / 选「表格」或点工具栏表格图标插表,点格子填,Tab 跳格

表格建好之后,下一个常见问题来了:表格里怎样再加一列?那篇同样先讲手改源码的正路,再讲 mdview 里鼠标点一下就加列的偷懒办法。更多编辑器快捷键见这篇速查。