README file from
GithubBases Export to Excel
一键将当前 Bases(.base) 视图的筛选结果导出为本地 Excel(.xlsx) 文件,并弹出「存储位置」选择框。
纯 JavaScript 实现,无任何第三方依赖:用 obsidian.parseYaml 解析 .base,
在本地复刻其 filters / order / sort 逻辑,手写 OOXML(Stored ZIP)生成真正的 .xlsx,
通过 Electron 保存对话框选择目录与文件名,导出后自动用默认程序打开。
功能
- 读取当前打开的
.base文件(或处于激活状态的 Bases 视图)。 - 完整支持 Bases 的筛选语法:
and / or / not分组,以及file.path.startsWith(...)、file.ext == "md"、file.tags.contains("#文献笔记")、file.name != "..."、property.字段等表达式。 - 按
.base中order定义的列导出,并按sort排序。 - 点击工具栏表格图标,或命令面板执行「导出当前 Bases 筛选结果为 Excel」。
- 弹出系统「另存为」对话框,自由选择目录与文件名(默认保存在
.base同目录)。 - 导出完成后自动打开该 Excel 文件。
安装(手动 / BRAT)
方式一:BRAT(推荐,便于更新)
- 社区插件市场安装 BRAT。
- 命令面板 →
BRAT: Add a beta plugin。 - 填入仓库地址:
GroupiesM/Obsidian-bases-export-xlsx-Plugin。 - 启用插件即可。
方式二:手动
将本仓库的 main.js / manifest.json / styles.css / versions.json
放入 Vault 的 .obsidian/plugins/bases-export-xlsx/ 目录,重启 Obsidian 并在
「设置 → 社区插件」中启用。
使用
- 在 Obsidian 中打开任意一个
.base文件(切到表格视图)。 - 点击左侧工具栏的 表格图标,或
Cmd/Ctrl + P→ 搜索「导出当前 Bases 筛选结果为 Excel」。 - 在弹出的对话框中选择保存目录、填写文件名,确认。
- 生成的
.xlsx会自动用 Excel / Numbers 打开。
说明与局限
- 本插件为 桌面端专用(
isDesktopOnly: true),依赖 Electron 保存对话框。 - 筛选求值是对 Bases 查询引擎的「实用子集」复刻,覆盖常见表达式;极特殊的公式写法会按「宽松放行」处理(即不过滤掉该行)。
- 不支持 Bases 的公式计算列(
formulas)结果,仅导出order中列出的属性字段。
构建
本插件无需构建步骤:main.js 即最终产物(CommonJS,Obsidian 直接加载)。
如需修改,编辑 main.js 后重启/重载 Obsidian 即可。