知识星球自动化发布工具

我写了一个工具，终于把「写 Markdown → 发知识星球」这件事解放了

如果你也是技术博主，可能对下面的场景不陌生👇

• 本地用 Obsidian / Typora / VS Code 写 Markdown，行云流水

• 一到发 知识星球：

  • 代码块没高亮，灰底黑字，一股“文档味”
  • 标题层级全乱，阅读体验直接崩
  • 稍微写长一点就 字数超限，发不出去
  • 还要手动拆文章、再手动发动态引流

说实话，这事我忍了很久。

直到有一天我意识到：
问题不是我不会排版，而是这件事本身就该自动化。

于是，我写了一个工具。

Zsxq-Auto-Publisher：给技术博主用的「知识星球自动发布器」

这是一个专门为技术内容创作者设计的自动化工具，目标只有一个：

👉 你只管写 Markdown，其它的交给脚本。

它做的事情很简单，但很“狠”：

• 从本地读取 Markdown
• 自动渲染成 OpenWrite / MDNice 风格
• 自动拆分长文
• 自动发布「长文 + 动态」联动
• 一次配置，长期使用

我现在发星球，基本就是一句话：

python main.py

然后去喝咖啡 ☕。

它到底帮我解决了哪些“长期折磨”？

1️⃣ 终于不用忍受丑到爆的代码块了

我直接像素级复刻了 OpenWrite / MDNice 风格：

• 深色 Mac 风格代码块
• 顶部栏 + 语言标识
• 圆角 + 阴影，极客感拉满

在星球 App 里看起来，已经非常接近公众号效果。

👉 没有外部 CSS，全是内联样式，星球不会过滤。

2️⃣ 长文再也不怕发不出去

知识星球对长文有隐形的 HTML 长度限制，踩过坑的都懂。

这个工具直接帮你：

• 自动检测长度

• 按 二级标题 语义拆分

• 自动生成

  《标题（1/3）》《标题（2/3）》这种结构

不是“硬切字数”，而是读起来完全顺的那种拆分。

3️⃣ 长文 + 动态，引流一次搞定

你不用再：

• 先发长文
• 再复制链接
• 再手写一条动态

脚本会自动帮你做这些事：

• 用 /articles 接口发长文
• 用 /topics 接口发动态
• 自动生成前 120 字摘要
• 动态里直接挂载长文卡片

效果就是：
刷到动态 → 点进去 → 看完整技术文章

4️⃣ 标签不再是玄学

如果你用过星球 API，一定被标签恶心过：

• #Java#、#架构#
• 多一个少一个 # 都不行

这个工具支持模糊匹配标签：

"target_tags": ["Java", "架构", "源码分析"]

剩下的交给脚本。

5️⃣ 不怕失败、不怕误操作

我给它加了很多「工程化」的保护：

• ✅ 网络失败自动重试
• ✅ 特定错误码直接中断（避免无效重试）
• ✅ published.log 本地幂等记录
• ✅ 同一篇文章绝不会重复发布

你可以放心反复跑脚本。

适合谁用？

非常明确👇

• ✅ 写 Java / 后端 / 架构 / 源码分析 的技术博主
• ✅ 长期在 知识星球 输出内容
• ✅ 本地 Markdown 重度用户
• ❌ 不适合只偶尔发几句碎碎念的人

我为什么愿意把这个工具写出来？

因为我自己就是那个：

• 爱写长技术文
• 对排版有点强迫症
• 又不想把时间浪费在重复劳动上的人

技术人就该把时间用在“内容”上，而不是“复制粘贴 + 调格式”。

后面我会分享什么？

在星球里，我会继续拆解这个项目的：

• 星球 API 的一些坑
• Markdown → HTML 的渲染策略
• 自动化发布的工程设计思路
• 以及更多 “技术创作者效率工具”

如果你对这些东西感兴趣，
你大概率会喜欢这个项目。

效果

欢迎加入星球：