【插件发布】Vtable — 行内表格增强!行列调整+回车换行 + 合并单元格 + 公式计算 + 一键图表?!

最近开发了一款 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 五种聚合函数。
实在很懒,就录了一个GIF

5. 一键图表

选中表格数据,一键生成柱状图、饼图、折线图,自动适配深色/浅色主题。
折线图
(这里以折线图为例)

6. 自动图表模板生成

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

7. 更多细节

  • 单元格内支持 **粗体**、*斜体*、==高亮==、~~删除~~、行内代码、链接、Obsidian 图片嵌入、LaTeX 公式、HTML 标签直接渲染

  • 浮动工具栏(加粗/斜体/字号/合并/插入行列)

  • 格式互转:Markdown ↔ vtable ↔ HTML。(你甚至可以把它当作转换器?)


如何安装?

通过Obsidian-brat插件安装

  1. 下载BRAT插件
  2. 打开设置,添加Beta插件
  3. 输入https://github.com/Ming145/Vtable,选择最新版本
  4. 启用

手动下载安装:

  1. 前往 Gitee Release 页面下载三个文件:main.js、manifest.json、styles.css
    :backhand_index_pointing_right: https://gitee.com/vmsimab/vtable/releases

  2. 在 Obsidian 仓库的 .obsidian/plugins/ 下新建 Vtable 文件夹

  3. 把三个文件放进去

  4. 在 Obsidian 设置 → 第三方插件中启用

教程

这里讲的很草率,细节请到Vtable: Vtable —— 在 Obsidian 中创建富文本增强表格。每一个单元格都能独立支持较为完整的渲染,且支持单元格合并。底层基于标准 JSON 格式,简洁透明、易于读写 看README哦


开源

插件已在 Gitee 和 Github上完全开源(MIT 许可证),欢迎各位大佬提 Issue、PR 或者点个 Star 鼓励一下 :folded_hands:(第一次开发,甚至是AI写代码,有很多不懂的,望指教)
:backhand_index_pointing_right: Gitee链接
Github链接


如果使用中遇到任何问题,欢迎在论坛回复或到 Gitee 提 Issue,但是我可能修复不是很及时(不要抱有太大希望~)。

1 个赞

合并单元格神技,浮窗控制能否改成行内右键菜单

感谢支持,我后来去试了一下,如果你指的是右键合并、拆分、添加单元格,对单元格进行操作,你这个应该是可以的,当前版本就可以实现。

至于如果不想要开启浮窗,在设置里可以关闭,这样格式的输入就要依靠手动写markdown和html了,不过浮窗关掉后肯定都是可以实现的。见 https://gitee.com/vmsimab/vtable#右键菜单

看到了,就是删除整张表的时候能不能做个快捷键

用这个插件还可以避免,表格上方空行:+1:

感谢!这个需求记下了,下一版本统一更新

现在可以再去看一下,我已经做了更新了

通知:bell::现在已经上传到github仓库,可以在BRAT中输入https://github.com/Ming145/Vtable安装啦

那看来有bug,得修一下了

不对,删除按钮是自带的,只删除代码。你设置的删除方式是在哪里,右键没看到

我刚才那个确实有点问题,不过正好你也没有找到。现在我更新了新版本,删除方式按你说的采用了快捷键。
现在可以设置删除表格的快捷键,当光标在表格下方一格时,按下设置的快捷键,即可删除上方的表格。
注意:不要在表格内按删除

可以了,我把这个删除命令做成了右键快捷键,现在很方便了

嗯,看起来不错。这个是改了源码还是另加插件做的?

插件的功能,可以自定义命令到右键菜单。

1.0.3更新!

修复一点bug、优化用户体验和深色模式支持。
(源码不知道为什么推不上去,不过发行版都已经更新啦!)

删除的快捷键好像没了

嗯…有点奇怪。建议可以先用brat回退成旧版本,我后面努力补上

最新版本应该已经修复了,请查看

可以了 :+1: