Repository navigation
Releases
0.0.4
Export as Markdown 0.0.4
Adopts Obsidian's declarative settings API, so the plugin's settings now appear in Obsidian's settings search. No changes to export behavior — exporting works exactly like 0.0.3.
settings.ts: implementsgetSettingDefinitions(); Obsidian 1.13 and later renders the tab from those definitions and indexes them for settings search.display()stays as the fallback for 1.8–1.12, sominAppVersionis still 1.8.7.- Removed the top-level "General" heading, per the style guide.
- Creating the destination folder no longer relies on Node.js type declarations to inspect the error code.
obsidiantypings pinned to^1.14.4indevDependencies, since the declarative API types first ship in 1.13.- Both READMEs: added a permissions note describing the
fsandchild_processusage.
Requires a separately installed obsidian-export. Desktop only.
Export as Markdown 0.0.4(简体中文)
改用 Obsidian 声明式设置 API,设置项现在可以在设置搜索中检索。导出行为无变化,与 0.0.3 一致。
settings.ts:实现getSettingDefinitions();Obsidian 1.13 及以上由声明式定义渲染并纳入设置搜索,1.8–1.12 仍保留display()兜底,minAppVersion维持 1.8.7。- 按样式指南移除设置页顶部的"通用"标题。
- 创建目标目录时不再依赖 Node.js 类型声明判断错误码。
devDependencies中的obsidian固定为^1.14.4:声明式 API 的类型定义自 1.13 起提供。- 中英文 README 新增权限说明,描述
fs与child_process的用途。
需自行安装 obsidian-export,仅支持桌面端。
0.0.3
Export as Markdown 0.0.3
Fixes the only blocking item from the community directory review of 0.0.2. No functional changes — behaves exactly like 0.0.2.
manifest.json: rewordeddescriptionso it no longer contains the word "Obsidian" (the previous text matched it insideobsidian-export), which the automated manifest check rejects.- Version bumped to 0.0.3 so the review can rescan a published release.
Requires a separately installed obsidian-export. Desktop only.
Export as Markdown 0.0.3(简体中文)
修复社区目录对 0.0.2 的审核中唯一的阻断项,功能无变化,行为与 0.0.2 一致。
manifest.json:调整description,不再包含 “Obsidian” 一词(原描述在obsidian-export中命中该关键词),此前被清单自动检查判为错误。- 版本号升至 0.0.3,以便审核重新扫描已发布的版本。
需自行安装 obsidian-export,仅支持桌面端。
0.0.2
Export as Markdown 0.0.2
Prepares the plugin for the Obsidian community directory. No functional changes — behaves exactly like 0.0.1.
manifest.json: added the requiredauthorandauthorUrlfields.README: documented that exports are written outside the vault, and added a license section.
Requires a separately installed obsidian-export. Desktop only.
Export as Markdown 0.0.2(简体中文)
为提交 Obsidian 社区目录做准备,功能无变化,行为与 0.0.1 一致。
manifest.json:补充必填的author与authorUrl。README:说明导出结果写入仓库之外的目录,并补充许可证小节。
需自行安装 obsidian-export,仅支持桌面端。
0.0.1
Export as Markdown 0.0.1
First release. This plugin runs your local obsidian-export CLI from inside Obsidian, so notes that use reference-style syntax can be shared as a single plain Markdown file instead of a PDF.
Requirements
- obsidian-export must be installed separately — it is not bundled with the plugin. Download a binary from its releases and add it to
PATH, or runcargo install obsidian-export. - Confirm it works with
obsidian-export --version. - Desktop only.
Features
- Export the current note, a folder, or the entire vault.
- Available from the command palette, a ribbon icon (exports the active note, or the whole vault when no note is active), and an Export item in the file menu for notes and folders.
- Choose a destination with Browse… or paste a path; it is created when missing.
- Preview the exact command that will run, follow live logs, and cancel at any time.
- When the destination is not empty, review the files expected to be overwritten and confirm first (can be disabled in settings).
- See the files actually written once the export finishes.
- The last destination folder is remembered.
- Interface in English and Simplified Chinese; follows Obsidian's language by default and can be overridden in settings.
- Settings for the common obsidian-export flags:
--no-git,--frontmatter,--hidden,--preserve-mtime,--hard-linebreaks,--no-recursive-embeds, plus extra arguments.
Notes
- Runs entirely on your machine: no network requests, and no vault contents leave your device.
- The destination cannot be the vault root. Exporting into the vault shows a warning, because Obsidian will index the exported files and a later full-vault export may pick them up again.
- The output layout is decided by obsidian-export: folder exports are flattened into the destination, vault exports keep the folder structure.
Install
- Download
main.js,manifest.jsonandstyles.cssfrom the assets below. - Copy them to
<Vault>/.obsidian/plugins/export-as-markdown/. - Enable Export as Markdown in Settings → Community plugins.
Export as Markdown 0.0.1(简体中文)
首个版本。本插件让你直接在 Obsidian 中调用本机安装的 obsidian-export 命令行工具,把使用引用写法的笔记导出为单个普通 Markdown 文件,便于分享(不再需要导出成 PDF)。
前置条件
- 需自行安装 obsidian-export,插件不包含该工具。可从其 Releases 下载二进制并加入
PATH,或执行cargo install obsidian-export。 - 用
obsidian-export --version确认可用。 - 仅支持桌面端。
功能
- 导出当前笔记、指定文件夹或整个仓库。
- 可通过命令面板、左侧功能区图标(有活动笔记时导出当前笔记,否则导出整个仓库),以及笔记/文件夹右键菜单中的 Export 触发。
- 通过 浏览… 选择目标目录或直接粘贴路径,目录不存在时自动创建。
- 实时显示将执行的命令和运行日志,可随时取消。
- 目标目录不为空时,先列出预计被覆盖的文件并确认(可在设置中关闭)。
- 导出结束后列出本次实际写入的文件。
- 记住上次使用的目标目录。
- 界面支持简体中文和英文,默认跟随 Obsidian 语言,也可在设置中指定。
- 设置项覆盖 obsidian-export 常用参数:
--no-git、--frontmatter、--hidden、--preserve-mtime、--hard-linebreaks、--no-recursive-embeds,并支持额外参数。
说明
- 全程在本机运行:不发起网络请求,也不会上传任何仓库内容。
- 目标目录不能是仓库根目录;导出到仓库内部时会给出提示,因为导出结果会被 Obsidian 索引,之后导出整个仓库时可能被再次包含。
- 导出布局由 obsidian-export 决定:导出文件夹时笔记平铺到目标目录,导出整个仓库时保留目录结构。
安装
- 下载下方资产中的
main.js、manifest.json和styles.css。 - 复制到
<Vault>/.obsidian/plugins/export-as-markdown/。 - 在 设置 → 第三方插件 中启用 Export as Markdown。