Obsidian 干净 Markdown 导出

要解决的具体问题

Obsidian 仓库的价值在于 [[wikilink]]、附件、文件夹和本地元数据构成的知识网络，但这些约定并不等于适合发布或下游处理的 Markdown。直接把 vault 复制出去，链接语义、附件引用和 frontmatter 可能被静态站点生成器、检索索引或迁移脚本误判；发布到 GitHub Pages、文档站或新 wiki 时，往往还要手动拆解目录、改写链接和整理图片。

技能如何工作

这个技能把问题收敛为一次可重复的导出：使用 obsidian-export CLI 和源 vault 目录作为输入，将笔记内容、wikilinks 与附件转换为可移植的 Markdown 树。核心步骤是先准备一个已存在的空目标目录，再从终端或 Windows PowerShell 运行命令，得到结构清晰的输出目录，供发布、索引或迁移使用。若项目附带 docs 目录和 generate.sh，可按这些入口快速验证流程。

适用边界与注意点

它适合 发布前清理、跨工具迁移 和 批量入库，但不负责把 Obsidian 的全部插件生态搬走。目标目录必须提前创建；命令行文本界面不能在 GUI 双击完成。部分静态站点生成器要求 frontmatter 必须存在，源笔记没有时仍需后续补齐。上游依赖 obsidian-export，二进制与文档来自关联仓库。