最近开发了一款 Obsidian 表格增强插件——Vtable,主要解决原生 Markdown 表格的几大痛点,第一次开发,过程还是比较坎坷的。分享给大家。
原生表格用着哪里不舒服?
不知道大家有没有和我一样的感觉:
-
想在单元格里换行写点内容,一按
Enter就跳到下一格了,非常烦 -
想合并表头或跨行跨列?不行
-
想算个合计?掏出计算器手动加,或者贴到 Excel 里
-
想做个数据图表?得用其他工具做完再截图贴回来
-
HTML表格不支持Latex?
这些问题虽然不大,但日常笔记里碰到了就很烦。所以干脆自己写了个插件,把这些“本应如此”的功能补全。
Vtable 能做什么?
1. 格内回车换行
在单元格里按 Enter 是换行。终于可以像写文档一样做表格了。
2. 合并单元格
合并表头或跨行跨列,支持拆分还原。做复杂表格终于不用写 HTML 了。
注意:不能一次性合并多格(大于2),只能先合并两个,再把合并好的当做一格合并。Ctrl+Z一步一步撤回,拆分则一次全部撤销。
3.三种模式
三种显示模式(OL / HS / RC)
进入 Live Preview 编辑表格时,表格左上方会出现三个半透明圆角切换按钮:
| 模式 | 说明 |
|---|---|
| OL | 原始换行模式(默认):单元格内回车换行,自动折行 |
| HS | 横向拉长模式:文字不换行、持续向右延伸;表格下方有可拖拽滚动条(桌面/移动端均可拖动) |
| RC | 自由拖拽模式:单元格右/下边缘出现专用拖拽手柄;内容增多自动撑高行 |
- 模式选择会写入代码块 JSON 并记忆,下次打开同一表格自动恢复
- RC 模式的
colWidths/rowHeights仅在 RC 下生效,不影响 OL / HS 显示 - 内容增多时 RC 模式自动撑高行(列宽不变);内容减少时行高不自动缩小
- 预览模式、源码模式、未聚焦单元格时,模式按钮自动隐藏
- 可在设置中控制是否显示模式切换按钮
4. 公式计算
输入 =SUM(A1:B3) 直接出结果,支持 SUM、AVERAGE、COUNT、MIN、MAX 五种聚合函数。

5. 一键图表
选中表格数据,一键生成柱状图、饼图、折线图,自动适配深色/浅色主题。

(这里以折线图为例)
6. 自动图表模板生成
插件启用后会自动在你的模板文件夹里生成三个图表模板文件(柱状图/饼图/折线图),打开就能填数据,不用自己对照规范手搓表头。

7. 更多细节
-
单元格内支持
**粗体**、*斜体*、==高亮==、~~删除~~、行内代码、链接、Obsidian 图片嵌入、LaTeX 公式、HTML 标签直接渲染 -
浮动工具栏(加粗/斜体/字号/合并/插入行列)
-
格式互转:Markdown ↔ vtable ↔ HTML。(你甚至可以把它当作转换器?)
如何安装?
通过Obsidian-brat插件安装
- 下载BRAT插件
- 打开设置,添加Beta插件
- 输入
https://github.com/Ming145/Vtable,选择最新版本 - 启用
手动下载安装:
-
前往 Gitee Release 页面下载三个文件:
main.js、manifest.json、styles.css
https://gitee.com/vmsimab/vtable/releases -
在 Obsidian 仓库的
.obsidian/plugins/下新建Vtable文件夹 -
把三个文件放进去
-
在 Obsidian 设置 → 第三方插件中启用
教程
这里讲的很草率,细节请到Vtable: Vtable —— 在 Obsidian 中创建富文本增强表格。每一个单元格都能独立支持较为完整的渲染,且支持单元格合并。底层基于标准 JSON 格式,简洁透明、易于读写 看README哦
开源
插件已在 Gitee 和 Github上完全开源(MIT 许可证),欢迎各位大佬提 Issue、PR 或者点个 Star 鼓励一下
(第一次开发,甚至是AI写代码,有很多不懂的,望指教)
Gitee链接
Github链接
如果使用中遇到任何问题,欢迎在论坛回复或到 Gitee 提 Issue,但是我可能修复不是很及时(不要抱有太大希望~)。



