发布功能
概述
Obsidian Publish 是官方提供的笔记发布服务，可以将你的仓库内容发布为公开网站，与他人分享知识。
开始使用
订阅服务
Obsidian Publish 需要单独订阅：
- 访问 Obsidian 官网
- 选择 Publish 服务订阅
- 完成付款
启用发布
- 打开设置 → 核心插件
- 启用「发布」插件
- 点击发布图标打开发布面板
发布流程
选择内容
在发布面板中：
- 未发布：显示仓库中未发布的笔记
- 已发布：显示已发布的笔记
- 已更改：显示有更新的已发布笔记
发布步骤
- 选择要发布的笔记
- 点击「发布」按钮
- 等待上传完成
- 访问发布的网站
更新内容
修改已发布笔记后：
- 打开发布面板
- 查看「已更改」列表
- 选择要更新的笔记
- 点击「发布更改」
取消发布
要移除已发布的内容：
- 在「已发布」列表中选择笔记
- 点击「取消发布」
网站配置
基本信息
在发布设置中配置：
yaml
站点设置:
- 站点名称: 显示在浏览器标签
- 站点图标: Favicon 图片
- 首页: 默认打开的页面外观设置
yaml
外观选项:
- 主题: 深色/浅色/跟随系统
- 界面语言: 支持多种语言
- 字体设置: 自定义字体
- CSS 代码片段: 应用自定义样式导航设置
yaml
导航选项:
- 显示文件树: 左侧文件导航
- 显示大纲: 右侧目录导航
- 显示反向链接: 显示链接关系
- 显示搜索: 启用搜索功能自定义域名
配置步骤
- 在发布设置中找到「自定义域名」
- 输入你的域名
- 配置 DNS 记录
DNS 配置
添加 CNAME 记录：
类型: CNAME
名称: www (或 @)
值: publish.obsidian.mdHTTPS 证书
Obsidian Publish 自动提供：
- Let's Encrypt SSL 证书
- 自动续期
- 强制 HTTPS
权限控制
密码保护
为网站设置访问密码：
- 打开发布设置 → 访问控制
- 添加密码
- 访问时需要输入密码
多密码管理
可以设置多个密码：
- 为不同用户设置不同密码
- 随时撤销特定密码
- 查看访问日志
SEO 优化
元数据设置
在笔记的 frontmatter 中添加：
yaml
---
title: 页面标题
description: 页面描述
image: /images/og-image.png
---站点地图
Obsidian Publish 自动生成站点地图：
- 位于
/sitemap.xml - 自动提交到搜索引擎
robots.txt
默认配置允许搜索引擎索引：
User-agent: *
Allow: /最佳实践
- 为每个页面设置唯一的标题和描述
- 使用语义化的标题结构
- 添加高质量的内容
- 获取外部链接
自定义样式
CSS 注入
添加自定义 CSS：
- 创建 CSS 文件
- 在发布设置中添加 CSS 代码片段
- 发布包含 CSS 的笔记
常用自定义
css
/* 修改背景色 */
.theme-light {
--background-primary: #ffffff;
}
/* 自定义字体 */
body {
font-family: 'Custom Font', sans-serif;
}
/* 隐藏元素 */
.nav-folder-title-content {
display: none;
}
/* 添加页脚 */
.site-footer::after {
content: "© 2024 My Site";
}自定义域名样式
可以完全自定义网站外观：
- 上传自定义 CSS
- 添加网站图标
- 配置品牌颜色
发布管理
版本控制
每次发布都会保存版本：
- 查看发布历史
- 回滚到之前版本
- 比较版本差异
发布统计
查看网站统计：
- 页面访问量
- 访客来源
- 热门内容
团队协作
多人协作管理：
- 邀请团队成员
- 分配编辑权限
- 共享发布管理
高级功能
重定向
配置页面重定向：
- 在 frontmatter 中添加：
yaml
---
permalink: /new-path
redirect_from:
- /old-path
---隐藏内容
发布时排除特定内容：
markdown
This is public content.
%% This content will not be published %%
More public content.嵌入内容
发布的内容支持：
- 内部链接
- 图片嵌入
- 代码高亮
- 数学公式
- Mermaid 图表
定价与限制
订阅计划
| 项目 | 说明 |
|---|---|
| 价格 | $8/月（年付）或 $10/月（月付） |
| 站点数量 | 1 个站点 |
| 存储空间 | 无限制 |
| 带宽 | 无限制 |
功能对比
| 功能 | 免费用户 | 付费用户 |
|---|---|---|
| 发布笔记 | ✅ | ✅ |
| 自定义域名 | ❌ | ✅ |
| 密码保护 | ❌ | ✅ |
| SEO 优化 | 基础 | 完整 |
| 自定义样式 | ❌ | ✅ |
最佳实践
内容组织
- 使用清晰的文件夹结构
- 创建导航索引页面
- 添加面包屑导航
发布策略
- 定期更新内容
- 检查链接有效性
- 回复用户反馈
性能优化
- 压缩图片文件
- 减少嵌入内容
- 使用 CDN 加速
替代方案
静态网站生成器
如果不想使用官方服务：
- Quartz：基于 Hugo 的 Obsidian 发布工具
- Obsidian Export：导出为静态文件
- VitePress：本项目的发布方式
第三方托管
- GitHub Pages
- Netlify
- Vercel
- Cloudflare Pages
常见问题
发布后样式不对？
检查：
- CSS 文件是否发布
- 主题是否正确应用
- 自定义样式是否生效
图片无法显示？
确保：
- 图片文件已发布
- 链接路径正确
- 使用相对路径
更新不生效？
尝试：
- 清除浏览器缓存
- 重新发布
- 检查发布状态