系列前 28 篇把知识库从搭到用聊了个遍。前一篇的日记体系讲的是日常捕捉,这篇换个方向——怎么把笔记「发出去」。
能发出去的笔记,才算真的活过来。
并不是所有笔记都适合分享。但在这件事上有没有一套自己的判断标准,决定了笔记能不能产生更大的价值。
三个要分享的场景
第一个,团队协作。 踩了几个坑整理出来的排查指南,同事遇到同样问题。笔记就在 Obsidian 里,怎么直接给他看。不用重新写一遍的那种。
第二个,内容输出。 写了段时间笔记,有几篇整理得比较完整。想发到博客或社交媒体。重新打开、复制、调整格式,一套下来半小时没了。
第三个,个人品牌。 坚持写了一段以后,有些笔记确实能帮到人。分享出去是对自己思考的验证,也能收到反馈。
三个场景的共同点:笔记已经写好了。问题只是怎么安全方便地发出去。
三件事不能发
聊方案之前,先说分类。不是所有笔记都适合往外发。
可以直接发的 — 技术教程、实操指南、读书笔记、思考总结。写的时候就没带敏感信息,整理一下就能发。
需要脱敏的 — 里面有服务器 IP、域名、内部工具名、项目代码。这些笔记有价值,但发之前得把敏感信息换成「your-server-ip」「your-domain.com」。
不能发的 — 密码、API Key、客户信息、合同条款。不管怎么处理都不该出去。
有个简单的判断:出现具体域名、IP、账号名、金额,就标记为「需要脱敏」。不确定的时候选保守。
三种分享方案
方案一:直接导 Markdown
Obsidian 打开笔记,复制内容,粘贴到博客编辑器。
成本最低,适合偶尔发。缺点也很明显——每次要手动处理格式和嵌入图片。如果包含 Obsidian 内部的双向链接,还得一个个转成普通链接。
适合偶尔发一两篇的情况。
方案二:写个脚本自动化
笔记本身是 Markdown,流程可以写成脚本。
提取笔记内容 ↓ 把 [[wikilink]] 转成普通链接 ↓ 图片路径从本地换成可访问的 URL ↓ 替换敏感信息为占位符 ↓ 输出纯 Markdown 或 HTML
脚本一次写好,后面每次指定要发哪篇笔记就行。比手动复制省事不少。
适合有一定动手能力、分享频率不低也不高的情况。
方案三:搭个发布系统
我目前在用的方式。核心思路:笔记在 Obsidian 里不变,通过一套规则自动把选定的笔记同步到博客。
笔记加「publish」标签 ↓ 定时脚本扫描有此标签的笔记 ↓ 自动脱敏(替换 IP/域名) ↓ 格式转换(wikilink→普通链接,本地图片→URL) ↓ 推送到博客草稿箱 ↓ 手动确认后发布
好处很明显:在 Obsidian 里写东西,打一个「publish」标签,后续自动处理。保持一处编辑、多处发布的体验。
代价是前期的配置工作量。要搭博客、写同步脚本、配置脱敏规则。
实际跑了大半年的方案
用的是方案三,做了一些简化。
笔记写好以后,加 publish 标签。脚本定时检查,发现新标记的笔记就自动处理。脱敏→格式转换→推博客草稿箱。
脱敏那步花了点功夫。写了一套基于正则的替换规则,常见的 IP 段、域名前缀、内网地址都能自动匹配。匹配到的直接换成「your-ip」「your-domain.com」。遇到不确定的敏感内容,脚本跳过这篇,通知我手动确认。
跑了大半年,大部分笔记从写好到发出去,中间只需要看一眼确认。不用为了发一篇文章重新整理一遍。
四个提醒
- 图片。 本地笔记的图片路径是「/data/xxx.png」,发布出去没人能访问。要么把图片上传到图床,要么发布时自动上传。
- wikilink。 Obsidian 的 [[笔记名]] 在公开内容里没法直接点。要么转成普通 URL,要么换成带描述的文本链接。
- 隐私检查不能全自动。 脚本可以替换 IP 和域名。但上下文里的隐私信息机器判断不了。比如一篇笔记里写了「X 公司的项目周期是三个月」,X 公司该不该换成「某公司」——得人看一眼。
- 默认不发布。 设一个明确的标记(比如 publish 标签)。只有打标记的笔记才会进入发布流程。默认不发布,主动选择才发。
习惯比方案重要
分享笔记这件事,本质不是技术方案的问题。
写笔记的时候想一下「这篇以后会不会分享」,会直接影响记笔记的方式。来源记清楚、上下文写明白、不含敏感信息。这些习惯养成以后,分享只是多选一步。
从最简单的复制粘贴开始也行。先发一篇试试,觉得流程不顺再优化。
知识库搭建系列到这篇暂时告一段落。从第一篇的四层架构讲起,到采集、搜索、标签、自动化,再到这篇分享方案。如果对启动 Obsidian 知识库有兴趣,可以从第一篇开始看。