Obsidian 写作与发布
免费
Obsidian 写作与发布
习惯在 Obsidian 写作的站主,可以用 OPC手册管理器插件把本地手册上传为网站草稿:在本地写,在线上审,发布到网站。插件只做“本地 → 线上草稿”的单向上传;权限、价格和公开发布始终在网站后台完成,不会把线上正文写回本地。
写作约定
一个文件夹对应一本手册:
我的手册/
README.md # 手册介绍,发布后全文公开
第一章.md
第二章.md
进阶/内部笔记.md # 子目录忽略,不上传
附件/
流程图.png
- 只读取文件夹根部的 Markdown;子目录、未引用的图片和其他文件直接忽略。
- 支持标准 Markdown 图片和
![[流程图.png]],只上传正文实际引用的图片,可以共用 Vault 中的附件目录。 - 普通笔记链接不会自动上传目标笔记;嵌入另一篇笔记时插件会提示位置,请改为正文或普通链接。
- 本地属性中的类型、权限、价格和发布时间会被忽略,统一以网站后台设置为准。
首次连接
- 下载插件包,放入 Vault 的
.obsidian/plugins/并在 Obsidian 中启用,需桌面版 1.14.4 以上。 - 网站后台「内容管理 → Obsidian 连接」创建凭据,复制只显示一次的
whp_…。 - 在插件设置中填写网站 HTTPS 地址和凭据,保存并连接。凭据只能管理手册草稿与必要图片,可随时在后台撤销。
安装包下载与升级方法见 OPC手册管理器。
从本地到线上
- 载入:点击「批量载入文件夹」,勾选一个或多个手册目录。
- 比对:新建或关联线上手册,点击「确认目标并比对」,左右查看本地与线上文稿,可展开正文对照。
- 上传草稿:勾选确认后上传,进度依次为图片、文稿草稿、线上状态。上传不会公开任何内容。
- 网页审核发布:点击「打开网页手册设置」,设置手册详情、价格、导航与阅读权限;在「待发布更新」核对预览,一次发布全部或选中的章节。有错误或冲突时整批不上线。
日常更新
修改后点击「比对本地与线上」:
- 内容相同的文稿自动跳过,全部相同时提示无需上传;
- 本地有改动时,逐项确认「用本地覆盖线上草稿」,生成新的待发布修订,线上公开版本保持不变,直到在网页发布;
- 仅在线上存在的文稿保留不删;本地改名或删除不会推断为删除线上文章;
- 比对后网站又有修改时,该项停止,需重新比对,不会覆盖未查看的新版本。
网络中断后,插件先按原任务编号查询结果,不自动重发;确认后再继续,避免重复提交。