关于如何设置 Obsidian Publish 的视频即将在频道上线;现在你可以先阅读这篇设置教程:
15 分钟把你的笔记变成专业网站
Obsidian Publish 是什么,为什么你需要它
Obsidian Publish 是官方提供的笔记在线发布服务。你可以把它看作一座桥梁,一端是你私人的知识库,另一端是公开空间,让这些知识能够惠及更多人。
Obsidian Publish 的核心理念是:发布过程应当尽可能简单。你在熟悉的 Obsidian 界面中工作,标记要发布的笔记,点几下之后,就能得到一个完整的网站,所有链接、知识图谱以及 Obsidian 的独特功能都会被保留下来。
这项服务对研究人员、教师、顾问,以及所有创作教育类或专业内容的人来说尤其有价值。你的网站会自动拥有专业的外观、搜索功能和现代化的导航,而你无需学习任何网页开发知识。
Obsidian Publish 的主要优势
第一个,也是最主要的优势,是与你现有 Obsidian 工作流的无缝集成。所有的双向链接、反向链接、标签和文件夹结构都会自动同步到网站上。你可以照常使用笔记,所做的修改几乎会立刻反映到网站上。
第二个优势是在网页格式中保留了 Obsidian 的独特功能。知识图谱变得可交互,访问者可以探索你各个想法之间的联系。悬停预览让人无需离开当前页面,就能快速查看被链接笔记的内容。
第三个优势是技术上的可靠性。Obsidian Publish 运行在 Cloudflare 的基础设施之上,在全球范围内都有很快的加载速度和稳定的表现。需要说明的是,某些地区的部分用户在访问 Cloudflare 服务时偶尔可能会遇到一些问题,但在大多数情况下网站都能稳定运行。
一步步设置 Obsidian Publish
第 1 步:准备工作与订阅
在开始设置之前,请确保你已经开通了有效的 Obsidian Publish 订阅。这项服务按年付费是每月 8 美元,按月付费是每月 10 美元。
你可以通过 Obsidian 官网上的账户来订阅。付款完成后,Publish 插件就会出现在 Obsidian 的设置中。需要了解的是,订阅绑定的是你的账户,而不是某个特定的库,所以你可以在不同的库中使用 Publish。
第 2 步:启用 Publish 插件
通过左下角的齿轮图标或快捷键 Ctrl+逗号(Mac 上为 Cmd+逗号)打开 Obsidian 的设置。在“核心插件”部分找到“发布”(Publish)并启用。启用后,左侧边栏会出现一个带云朵和向上箭头的新图标,这就是你的发布控制中心。
首次启动该插件时,系统会提示你登录 Obsidian 账户。请使用注册和支付订阅时填写的同一账户信息。授权过程只需几秒钟,并且需要联网。
第 3 步:创建新站点
点击左侧边栏中的 Publish 图标。如果你还没有任何站点,系统会提示你创建一个新站点。在“Site ID”字段中,为你的站点填写一个唯一标识符。它将成为你站点 URL 的一部分,格式为 publish.obsidian.md/your-site-id。
请慎重选择 Site ID,因为之后很难更改。比较好的选择有:你的名字、项目名称、内容主题。避免使用随机字符和数字,你的 URL 应该容易记忆,并且看起来专业。
站点创建完成后,你会看到发布管理界面,其中有三个主要标签页:“NEW”(待发布的新笔记)、“CHANGED”(已修改的笔记)和“UNCHANGED”(已发布的笔记)。
第 4 步:发布你的第一批笔记
一开始,先从你的库中挑选 3 到 5 篇最好的笔记。它们应该是已经完成的高质量内容,能很好地体现你的思考方式和专业水平。在“NEW”标签页中勾选这些笔记,然后点击“Publish”。
Obsidian 会自动分析所选笔记,并建议添加相关文件,比如图片和被链接的其他笔记。“Add linked”功能有助于避免你的网站上出现失效链接。请仔细检查建议添加的文件,并取消勾选你不想发布的那些。
发布过程需要几秒到几分钟不等,取决于文件的数量和大小。完成后,你会看到发布成功的通知,以及指向你新站点的链接。
配置站点设置
打开站点设置
要进入站点设置,请打开 Publish 插件,点击站点名称右侧的齿轮图标。随后会打开“Site options”窗口,其中有许多参数会影响站点的外观和功能。
这些设置分为几个逻辑组:General(常规)、Appearance(外观)、Reading experience(阅读体验)和 Components(组件)。每一组负责站点的一个特定方面,了解这种划分能帮你更快找到需要的选项。
常规设置
Site Name(站点名称)是你站点的公开名称,会显示在浏览器标题和站点本身上。请选择一个能清楚体现主题或你个人特色的名称。例如“生产力笔记”或“Anna Ivanova 的数字花园”。
Homepage File(主页文件)决定别人进入站点时打开哪篇笔记。你可以创建一篇专门的欢迎笔记,简要介绍自己,按主要话题提供导航,并附上几篇你最好的内容。这个页面是你站点的门面,所以请格外用心。
Logo 可以让你在站点的页眉中添加一张徽标图片。徽标需要先上传到你的 Obsidian 库中,并作为普通文件发布。推荐尺寸为 200x60 像素,格式为 PNG 或 SVG,以便在所有设备上都保持清晰。
外观设置
Theme(主题)提供三个选项:Light(浅色)、Dark(深色)和 Adapt to System(跟随系统,即适配用户的系统设置)。选择主题不只是审美问题,也关系到阅读的舒适度。深色主题能减轻在黑暗环境中阅读时的眼睛疲劳,但对于包含图表和示意图的文档可能不太合适。
Light/Dark Toggle(浅色/深色切换)会在站点界面中添加一个主题切换按钮,让访问者选择适合自己的模式。如果你的读者在一天中的不同时间阅读内容,这个功能就特别有用。
阅读体验设置
Show hover preview(显示悬停预览)会在鼠标悬停于内部链接上时弹出预览。这是 Obsidian Publish 最强大的功能之一,读者无需跳转到其他页面,就能快速查看相关内容。对于笔记之间关联很多的站点,这个功能尤其有用。
Hide page title(隐藏页面标题)会隐藏页面顶部的笔记标题。如果你更喜欢极简的设计,或者笔记标题已经融入正文,就可以使用这个选项。
Readable line length(可读行宽)会限制文本宽度以提升可读性。过长的行会让眼睛疲劳,因此对于有大段文字的站点,推荐开启此选项。
Strict line breaks(严格换行)会影响 Markdown 中换行的显示。开启后,单个换行会显示为换行,这对诗歌或结构化列表可能很有用。
Stack Pages(堆叠页面)会启用“页面堆叠”模式,可以像标签页一样同时打开多篇笔记。这个功能适合对比资料,或同时处理几个相关主题。
组件设置
显示导航会在站点左侧面板中添加一个文件浏览器，让访客可以看到你的笔记结构，并快速在各个板块之间跳转。对于板块众多的大型站点，导航尤为重要。
自定义导航可以让你调整导航中文件和文件夹的显示顺序。你可以通过拖动来重新排列条目，也可以对访客隐藏某些文件或文件夹。
显示搜索栏会添加一个搜索栏，可搜索你已发布笔记的全部内容。搜索是实时的，并会在结果中高亮显示找到的关键词。
显示关系图谱会在右侧面板中启用交互式知识图谱。图谱展示笔记之间的关联，让访客可以用非线性的方式探索你的想法。这是 Obsidian Publish 的独特功能之一。
显示目录会根据 H1-H6 标题自动为每篇笔记生成目录。目录能帮助读者浏览较长的内容，并快速跳转到自己感兴趣的部分。
显示反向链接会列出链接到当前页面的笔记。这有助于你理解笔记的上下文，并找到相关资料。
进阶技巧与优化
为发布整理内容
高效的内容整理从 Obsidian 本身就开始了。可以专门建一个 _public 文件夹，存放准备发布的笔记。这样做能清楚地把私人想法和公开内容区分开。
用标签体系来给公开内容分类。例如，#article、#note、#resource 这几个标签可以帮助访客更快找到需要的内容类型。在 Obsidian Publish 中，标签会自动变成可点击的链接，并形成额外的导航路径。
创建 MOC（Maps of Content，内容地图）笔记——也就是站点每个主要主题的索引页。MOC 有助于梳理大量内容，也是新读者的入口。比如，一个“效率”MOC 可以包含指向你所有关于时间管理、习惯养成和整理工作空间的笔记的链接。
优化图片和媒体文件
Obsidian Publish 对文件大小和内容总量有限制，所以优化媒体文件至关重要。在把图片加入库之前先压缩，可以使用 TinyPNG 或 ImageOptim 这类服务。
推荐的图片格式：面向现代浏览器用 WebP，需要透明背景的图片用 PNG，照片用 JPEG。网页图片的最大宽度通常取 1200 像素，这足以在大多数设备上清晰显示。
对于图表和示意图，可以考虑使用矢量 SVG 格式。SVG 文件缩放不会损失画质，而且通常比同等复杂度的位图体积更小。
使用笔记属性
Obsidian 中的笔记属性（以前叫 frontmatter）为控制发布提供了强大的选项。你可以在每篇笔记开头添加一个包含元数据的 YAML 块：
---
title: "An SEO-optimised title"
description: "A short description for search engines"
tags: [productivity, planning]
publish: true
permalink: custom-url-slug
cover: "path/to/cover-image.jpg"
---publish: true 属性可用于自动把笔记加入待发布列表。在处理大量内容时尤其好用。
permalink 属性可以让你为笔记创建一个好看的 URL，而不是使用根据文件名自动生成的那个。这对 SEO 和链接的易记性都很重要。
设置自定义域名
为了看起来更专业，可以考虑把你自己的域名连接到 Obsidian Publish 站点。在站点设置中找到“Custom Domain”（自定义域名）部分，按照说明设置 DNS 记录。
设置自定义域名时，请确认你的域名注册商支持 CNAME 记录。大多数常见的注册商（Namecheap、GoDaddy、Cloudflare）都提供简单易用的 DNS 管理界面。
域名设置完成后，更改可能需要 24 到 48 小时才能在整个互联网上完全生效。在此期间，你的站点可能新旧两个地址都能访问。
内容的 SEO 优化
Obsidian Publish 会自动生成许多对 SEO 重要的元素，但你还可以进一步改进。笔记标题要有描述性，并包含你希望被搜索到的关键词。
在笔记属性中添加 description，用简短而信息丰富的文字描述内容。搜索引擎以及在社交媒体上分享时都会用到这段描述。
在相关笔记之间创建内部链接。良好的内部链接不仅能帮助读者找到相关内容，还能提升站点在搜索引擎中的排名。
自动化发布流程
对于经常更新的站点，可以养成每周检查是否有新内容需要发布的习惯。设置一个提醒，每周翻看一遍公开内容的文件夹，并更新站点。
使用发布过滤器，自动排除某些文件夹或文件类型。在 Publish 设置中，你可以指定永远不发布的文件夹，即使其中的笔记带有 publish: true 标记也不会被发布。
另外建一篇单独的更新日志笔记，记录你发布了什么、什么时候发布的。这有助于你追踪站点的发展，并规划后续内容。
解决常见问题
链接显示问题
如果内部链接无法正常工作，请检查所有被链接的笔记是否也已发布。Obsidian Publish 无法显示指向未发布笔记的链接。
对于指向外部资源的链接，请使用带协议的完整 URL（https://）。相对链接在网页环境中可能无法正常工作。
如果笔记在发布后被重命名，旧链接可能会失效。请重新发布所有相关笔记以更新链接。
图片问题
请确保所有图片也已加入待发布列表。图片不会随笔记自动发布，需要单独勾选。
检查笔记中的图片路径是否与它们在库中的位置一致。请使用从库根目录开始的相对路径。
如果图片仍不显示，可以尝试强制重新发布：取消勾选后再重新勾选。
站点可访问性问题
在少数情况下，用户访问 publish.obsidian.md 平台上的站点时可能会遇到暂时的困难。这可能与 Cloudflare CDN 在某些地区或特定网络服务商下的特性有关。
如果你发现这类问题，可以考虑通过其他 DNS 服务商设置自定义域名，或联系 Obsidian 官方支持，针对你的具体情况获取建议。
对于至关重要的内容，最好准备一个通过其他平台发布的备用方案。
大小与性能限制
Obsidian Publish 对站点总大小和文件数量有限制。请定期在站点设置中查看配额的使用情况。
为了优化大型站点的性能，可以考虑把旧内容归档。你可以为历史资料单独建一个归档站点。
避免发布特别大的文件（视频、体积很大的 PDF）。这类资料最好使用外部存储服务，再插入链接。
与分析和监控集成
设置 Google Analytics
要追踪访问情况，可以把 Google Analytics 连接到你的 Obsidian Publish 站点。此选项仅在使用自定义域名时可用。
在 Google Analytics 4 中创建一个新媒体资源，获取跟踪代码，并将其添加到站点设置的“Google Analytics tracking code”部分。代码格式为 G-XXXXXXXXXX。
连接分析工具后，你就能追踪访客数量、热门页面、流量来源以及用户在站点上的行为。
性能监控
使用 Google PageSpeed Insights 检查站点的加载速度。Obsidian Publish 针对快速运行做了优化，但体积较大的图片或复杂的结构仍可能拖慢加载。
定期检查站点上的所有链接是否有效。失效的内部链接会降低用户体验，也会影响 SEO。
留意读者通过社交媒体评论或私信给出的反馈。这能帮你发现分析数据中看不到的问题。
总结与建议
Obsidian Publish 是一款功能强大的个人知识发布工具，兼具易用性和专业能力。这个平台最大的优势在于，你可以专注于创作内容，而不用操心网站开发的技术细节。
从简单的开始：先发布几篇你最满意的笔记，配置好基础的站点设置，再逐步添加新内容。不要试图一次性把整个库都搬过去——与其做一个庞大却杂乱无章的站点，不如先打造一个小而精的站点。
请记住，数字花园的成功不是用笔记的数量来衡量的，而是看它对读者是否有用，以及你自己作为作者是否在不断成长。善用读者的反馈来改进已有内容，并创作新的材料。
Obsidian Publish 是对你想法的长期发展和个人专业声誉的一项投资。只要用得得当，它就能成为分享知识、围绕你的兴趣建立社区的有力工具。
继续阅读？