Obsidian 笔记如何变成网站

2026年6月8日

你在 Obsidian 里写的 Markdown，和 Astro 需要的格式几乎一致——主要差在 wikilink 和 callout 语法。

直接可用的部分

• 标题、列表、代码块、表格
• YAML frontmatter（title、description、pubDate）
• 标准 Markdown 链接 [text](url)

需要转换的部分

• [[双向链接]] → 普通 Markdown 链接或 remark 插件
• > [!note] callout → HTML 或自定义组件
• 嵌入 ![[image.png]] → 标准 ![alt](/path/image.png)

本 Demo 的定位

这是一个最小可运行示例：证明 output/site/astro 目录可以独立构建、独立部署。后续可以：

1. 写脚本从 output/ 同步 .md 到 src/content/blog/
2. 加 Tailwind 换肤
3. 对接 Pagefind 全文搜索