欢迎
markdown-publish 能把一个笔记文件夹(Obsidian vault 或普通 Markdown)变成一个快速的静态网站——就像你现在看到的这个。本网站正是用它从普通的 .md 文件构建而成。
想几次点击就拥有一个同样的网站?
打开 几次点击搞定——里面有三个按钮,剩下的全自动完成。
功能一览
- 搜索——即时搜索,直接在浏览器里运行(按
Ctrl+K)。 - 关系图谱——交互式笔记地图,就像 Obsidian 里那样(左侧的“Graph view”链接)。
- Canvas 白板——
.canvas文件会渲染成交互式白板:这里有一个在线示例。 - AI 智能体——网站通过 WebMCP 把笔记开放给 AI 智能体。
[[wikilinks]]、普通 markdown 链接、嵌入(embeds)、callouts、标签、脚注、代码高亮。- 深色/浅色主题、移动端适配、悬停链接时的笔记预览。
- SEO 开箱即用:sitemap、robots.txt、llms.txt、OG 卡片、JSON-LD。
- 页面地址支持非拉丁字符(如中文)——本站就是这样。
如何发布自己的笔记
| 方式 | 难度 | 指南 |
|---|---|---|
| Netlify / Vercel 按钮 | 2 次点击 | 几次点击搞定 |
| 现有 vault → GitHub | 10 分钟,无需终端 | 把现有 vault 放上 GitHub |
| 模板 + GitHub Pages | 3–4 次点击 | GitHub Pages |
| 自己的仓库 + workflow | 适合熟悉 git 的人 | GitHub Pages |
| Cloudflare Pages | 几分钟 | Cloudflare Pages |
| 本地用 CLI | 终端 | 命令行 |
发布好了?接下来看 如何更新网站。所有设置(名称、语言、发布哪些笔记)都在 配置 里。
代码在哪里
项目是开源的(MIT):github.com/abstractwebunit/markdown-publish。与 Obsidian.MD 没有任何隶属关系——它只是读取兼容格式的 vault。