发布功能

Obsidian Publish 是官方提供的笔记发布服务，可以将你的仓库内容发布为公开网站。

完整指南

本文介绍 Publish 核心插件的完整使用方法。关于自定义域名、SEO 优化、评论系统、统计分析等高级功能，请参阅 Obsidian Publish 完整指南。

启用发布

1. 打开设置 → 核心插件
2. 启用「发布」插件
3. 点击左侧功能区出现的发布图标（地球图标）

订阅要求

使用 Publish 功能需要 Obsidian 的 Publish 订阅（$8/月）。未订阅时可以预览发布界面，但无法实际发布内容。

发布流程

选择内容

在发布面板中查看三类内容：

• 未发布：仓库中尚未发布的笔记
• 已发布：已经发布到网站的笔记
• 已更改：已发布但有本地更新的笔记

发布步骤

1. 勾选要发布的笔记
2. 点击「发布」按钮
3. 等待上传完成
4. 访问 https://publish.obsidian.md/你的站点ID

更新与取消

• 更新已发布内容：在「已更改」列表中选择笔记 → 点击「发布更改」
• 取消发布：在「已发布」列表中取消勾选 → 点击「发布」按钮移除
• 批量操作：使用 Shift/Ctrl 多选笔记，一次性发布或取消

注意

取消发布不会删除本地笔记，仅从网站移除。

站点配置

在发布面板点击「更改站点选项」：

基本设置

设置项	说明
站点名称	浏览器标签显示的名称
首页文件	网站首页显示的笔记
导航行为	点击链接的打开方式（原地打开/新标签页）
主题	深色/浅色/跟随系统

外观定制

使用社区主题

1. 在仓库中安装社区主题
2. 发布时选择「包含主题」
3. 主题样式将自动应用到发布网站

自定义 CSS

创建 publish.css 文件添加自定义样式：

/* 自定义字体 */
body {
  font-family: 'LXGW WenKai', sans-serif;
}

/* 调整颜色 */
.theme-dark {
  --background-primary: #1a1a2e;
  --text-normal: #eaeaea;
}

/* 隐藏 frontmatter */
.frontmatter {
  display: none;
}

注意

publish.css 文件需要手动勾选发布到 Publish 站点，否则样式不会生效。

隐藏内容

使用注释标记

使用 %% 包裹的内容不会出现在发布站点：

这是公开内容。

%% 这段内容不会发布 %%

更多公开内容。

使用发布开关

在笔记的 frontmatter 中设置：

---
publish: false
---

该笔记不会出现在「未发布」列表中，也不会被意外发布。

排除文件夹

在 Publish 插件设置中添加排除规则：

• 排除特定文件夹（如 drafts/、private/）
• 使用通配符匹配（如 _* 排除所有下划线开头的文件夹）

密码保护

全站密码

为整个站点设置访问密码：

1. 打开站点选项
2. 设置「站点密码」
3. 访问者需要输入密码才能查看

部分密码

为特定笔记设置独立密码：

1. 在发布面板选择特定笔记
2. 点击右侧的密码图标
3. 设置该笔记的访问密码
4. 其他笔记仍然公开访问

安全提示

密码保护不是加密机制，仅用于防止随意访问。敏感信息（如密码、密钥、个人信息）不应发布到 Publish 站点。

链接与导航

内部链接

Obsidian 的双向链接在发布站点中同样工作：

• [[笔记名]] — 链接到已发布的笔记
• [[笔记名|显示文本]] — 使用自定义显示文本
• ![[图片.png]] — 嵌入图片

未发布链接

灰色链接表示目标笔记未发布：

• 发布目标笔记后链接自动变为正常颜色
• 或移除/替换该链接

导航栏

发布站点自动生成导航栏，基于仓库根目录的笔记列表。可以在站点选项中自定义导航栏的行为和显示方式。

定价

方案	价格	说明
Publish	$8/月	无限站点、自定义域名、密码保护
Sync + Publish	$16/月	同步服务 + 发布服务

商业用途

商业许可用户（$50/月）包含 Sync + Publish，另增优先支持。

替代方案

如果不想使用官方服务，还有免费方案可以发布 Obsidian 笔记：

方案	特点	适合场景
Quartz	基于 Hugo，支持双向链接渲染	数字花园、技术博客
VitePress	本项目使用的方案，Vue 生态	文档站、教程站
GitHub Pages	免费托管，配合静态站点生成器	开发者笔记
Netlify / Vercel	自动部署，全球 CDN	追求访问速度

详见 静态站点生成。

常见问题

图片无法显示？

确保图片文件已一同发布：

1. 在发布面板检查图片是否勾选发布
2. 图片使用相对路径引用（![[image.png]] 或 ![](image.png)）
3. 检查图片是否在排除文件夹中

链接显示为灰色？

灰色链接表示目标笔记未发布：

1. 发布目标笔记，链接自动恢复正常
2. 或移除该链接
3. 使用 %% 隐藏不需要发布的链接

发布后看不到更改？

1. 等待几秒让 CDN 缓存更新
2. 强制刷新页面（Ctrl+Shift+R）
3. 检查笔记是否在「已发布」列表中

如何编辑已发布笔记？

直接在 Obsidian 中编辑笔记，然后在发布面板的「已更改」列表中勾选更新，点击发布即可。

下一步

• Obsidian Publish 完整指南 — 自定义域名、SEO、评论系统、统计分析
• 安全与隐私 — 保护你的内容安全
• 静态站点生成 — 免费发布方案
• 数据备份 — 发布前的备份策略