Skip to content
 
 

Repository files navigation

Advanced Tables for Obsidian

🌍 语言 / Language:简体中文 | English

本仓库是 i18n 分支:在保留上游全部功能的基础上,新增界面语言支持(简体中文 / English),并移除设置页中的赞助信息。


✨ 功能亮点

为 Obsidian 的 Markdown 表格提供改进的编辑体验,同时保持与 Markdown 语法的完全兼容:

  • 🎨 自动格式化:输入时自动对齐并美化表格
  • ⌨️ 类 Excel 导航:Tab / Enter 在单元格和行之间快速移动
  • 🧮 表格公式:在 Markdown 表格中直接使用电子表格公式(求和、平均值等)
  • ➕ 行列操作:增删、移动列与行
  • ↔️ 列对齐:一键设置左 / 中 / 右对齐
  • 🔃 行排序:按光标所在列升序 / 降序排列
  • 📤 导出 CSV:一键导出为 CSV 格式
  • 📱 移动端支持:可在 Obsidian Mobile 上使用(详见下文)

演示

基础功能演示

公式演示


🌐 多语言支持(i18n)

本 Fork 新增了 i18n 多语言支持:

  • 支持 简体中文 和 English
  • 默认 自动跟随 Obsidian 界面语言(自动模式)
  • 可在插件设置中手动切换语言
  • 覆盖全部 UI:命令面板、设置面板、工具栏按钮提示、CSV 导出弹窗、通知消息

切换语言:设置 → 第三方插件 → Advanced Tables → 语言(Language) → 选择「自动 / 简体中文 / English」。

💡 提示:切换语言后,命令面板中的命令名称需重启 Obsidian 才能完全生效(Obsidian API 限制);设置项、工具栏、弹窗即时生效。


📖 使用方法

创建表格

  1. 输入一个 | 字符,然后输入表格的第一个表头
  2. 按 Tab 继续输入下一列表头,直到完成
  3. 按 Enter 进入第一行
  4. 按 Enter 添加新行,Tab 切换单元格

快捷键速查

当光标位于 Markdown 表格内时:

快捷键 功能
Tab 下一个单元格
Shift + Tab 上一个单元格
Enter 下一行
Ctrl + Shift + D 打开表格控制工具栏

也可以打开命令面板(Ctrl/Cmd + P)搜索 Advanced Tables,里面有大量命令可用。

表格公式

公式写在表格下方紧邻的一行。例如:

| 项目 | 金额 |
| --- | --- |
| 苹果 | 10 |
| 香蕉 | 20 |
| 总计 | SUM(ABOVE) |

在工具栏点击公式按钮(或运行「Evaluate table formulas」命令)即可计算。

完整的公式语法说明见 md-advanced-tables 公式文档(英文)。


📦 安装

方法一:Obsidian 社区插件(上游原版)

  1. 打开 Obsidian → 设置 → 第三方插件
  2. 关闭安全模式
  3. 浏览社区插件 → 搜索 "Advanced Tables"
  4. 安装并启用

方法二:手动安装(本 i18n Fork)

  1. 从 Releases 或构建产物获取 main.js、manifest.json、styles.css
  2. 放入你的 vault:.obsidian/plugins/table-editor-obsidian/
  3. 在 Obsidian 设置 → 第三方插件中启用

⚠️ 注意:若 vault 中已安装原版 Advanced Tables,直接覆盖 table-editor-obsidian 目录即可(插件 ID 相同);如需并存请改 manifest 中的 id 与目录名。

从源码构建

pnpm install
pnpm run build   # 产物在 main.js(tsc 类型检查 + esbuild 打包)

📱 Obsidian Mobile

移动端同样可以使用 Advanced Tables 插件。由于移动端键盘没有 Tab / Enter 导航键,建议:

  • 将「下一单元格 / 下一行」命令添加到移动端工具栏
  • 或使用侧边栏中的表格控制按钮

🗺️ 与上游的差异

特性 上游 本 Fork
界面语言 仅英文 ✅ 简体中文 + English + 自动
设置页赞助按钮 ✅ 有 ❌ 已移除
命令 / 设置 / 工具栏 英文硬编码 ✅ 词典驱动,可扩展更多语言
底层表格引擎 相同 相同

🙏 致谢


⚠️ 注意事项

本插件处于实验阶段,可能存在不稳定性。表格操作理论上不会丢失数据,但仍建议定期备份重要笔记。

About

Improved table navigation, formatting, and manipulation in Obsidian.md

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages