为什么要自托管分享
你按过的每一个“分享”按钮,都把你的文档传到了别人的服务器上,守着别人的条款,活到别人规定的日子。note.md 的分享插件往你的 Cloudflare 账号里部署一个小 Worker:你的链接,你的数据,你的总开关。免费档(每天 10 万请求)远超一个人分享文档所需。
十分钟部署
cd worker
pnpm install
wrangler login
wrangler kv:namespace create SHARES # copy the id into wrangler.toml
openssl rand -hex 32 | wrangler secret put SHARE_API_KEY
wrangler deploy # prints your Worker URL
把 Worker URL 和 API key 粘进 note.md → Preferences → Share,重启,完事。完整细节见仓库里的 worker/README.md。
你会得到什么
- 一个快捷键:
Cmd+Shift+L发布当前文件;URL 直接进剪贴板。再分享一次即原地更新;取消分享后返回 410。 - 忠实渲染:KaTeX 数学公式、Mermaid 图表转 SVG、语法高亮、跟随
prefers-color-scheme的明暗模式、移动端优化。 - 图片也带上:图多的文档会自动溢出到 Cloudflare R2(同样有免费档)。
- 为 agent 就绪:Worker 暴露一个 MCP 端点,你的 agent 可以代你发布——
notemd -s draft.md在任何脚本里都能跑。
FAQ
这要花多少钱?
个人使用一分不花。Cloudflare 免费档包含每天 10 万次 Worker 请求和 10GB 的 R2 存储——比一个人分享文档的用量高出几个数量级。
分享出去的页面能撤下来吗?
能,立刻。File → Unshare(或 notemd share --unshare)吊销链接;访客看到 410。Worker 是你的——你甚至可以直接把它删掉。