常见问题
网站能打开,但是“光秃秃”的:没有样式,笔记加载不出来,控制台里一堆 404
几乎总是 baseHref 的问题。在 GitHub Pages 上,网站位于子路径 /仓库名/ 下,构建时必须知道这一点:
- 在 workflow 里:
base-href: /仓库名/(见 GitHub Pages); - 在 Netlify/Vercel/Cloudflare 上,网站位于根路径——那里保持
/即可。
我部署了改动,但网站显示的还是旧内容
浏览器会顽固地缓存静态文件。按 Ctrl+Shift+R(强制刷新)或在隐身窗口打开。Canvas 白板尤其如此——它们是作为单独的文件加载的。
怎么隐藏一部分笔记?
在 配置 里设置 buildMode: public——只有 frontmatter 中带 publish: public 的笔记才会发布。其余的既不会进入构建,也不会出现在搜索和图谱里。
非拉丁字符的文件名(中文、西里尔字母等)可以吗?
可以。页面地址会保留原始字符(/笔记/我的笔记),与 Obsidian Publish 的做法一致。本网站就是一个活生生的例子。
笔记之间支持哪些链接?
[[wikilinks]](带 |别名、#标题)和普通的 [文本](另一篇笔记.md) 都支持。两种链接都会进入图谱和反向链接。
图片和附件?
把它们放在笔记旁边,照常插入:![[图片.png]] 或 。构建时文件会得到哈希文件名并进入网站。
这要花多少钱?
markdown-publish 本身免费且开源(MIT)。GitHub Pages、Netlify、Vercel 和 Cloudflare Pages 都有免费套餐,对个人笔记来说绰绰有余。
这是 Obsidian 的官方产品吗?
不是。该项目与 Obsidian.MD 没有任何隶属关系——它只是读取兼容的 vault 格式和 .canvas 文件(开放标准 JSON Canvas)。
没找到答案?去 issues 提问。