TL;DR：语雀自动发布文章有两条官方认可的路。一条是开放 API：申请 X-Auth-Token，但个人 Token 要开通超级会员才能用，团队 Token 只有旗舰版空间能用，还得自己写代码调 v2 接口。另一条是复用你已经登录的浏览器会话，直接调用语雀网页本身在用的接口发布——不用额外开会员，也不用自己写对接代码。
写完一篇技术复盘或者产品文档，打开语雀，新建文档，把 Markdown 一段段贴进去，代码块经常要重新调格式，图片得一张张重新拖。这套流程一个月做十几次，比写文章本身还烦。更烦的是，你去查“语雀自动发布”想找条近路，翻到的第一条官方说明就是：个人 Token 要超级会员，团队 Token 要旗舰版空间。
语雀写完之后，“发进去”这一步卡在哪
语雀本身没有“一键从本地 Markdown 文件发布”这个功能。官方给的路径是网页手动建文档，或者走开放 API 自己写脚本对接。前者纯手工，后者需要你会写代码，还要先解决权限问题。
这也是为什么搜“语雀 API”能搜到一堆第三方连接器（腾讯轻联、集简云这类零代码平台的语雀连接页），本质都是在帮不会写代码的人绕开“自己调 v2 接口”这一步。但绕不开的是权限门槛：这些工具接的还是同一套官方 Token 体系。
官方 API 这条路，真正的门槛不是技术，是会员身份
语雀开放 API 官方文档写得很直接：所有开放 API 都要在请求头带 X-Auth-Token。但拿到这个 Token 本身就分层：
- 个人 Token：文档标注为“超级会员专享权益”，普通账号进个人设置页面看不到申请入口。
- 团队 Token：标注为“旗舰版空间专享权益”，团队要买到最高档的空间套餐才能用。
也就是说，你想用官方 API 自动发一篇文章，第一步不是写代码，是先给账号或团队升级到对应付费档位。语雀定价随时间会调整，具体金额以语雀官方定价页为准，但“要先付费开权限，才能拿到调 API 的资格”这件事本身没得绕。
同一份文档里官方还写了一句容易被忽略的提醒：开放 API 仅用于对语雀内容的正常读写，系统识别到异常行为后会进行屏蔽处理，可能导致账号不可用。这条提醒不只是对着 API 用户说的：不管走哪条路径发布内容，按正常使用节奏来、别短时间内批量狂发，都是该守的边界，不是 API 专属的规矩。
本地登录态这条路怎么不一样
除了申请 Token 走开放 API，还有一条路：直接复用你已经在 Chrome 里登录的语雀会话，让程序像网页本身一样调用那套内部接口。这正是 PublishPort 底层 ppcli 工具对语雀这块的实现方式，流程和网页手动操作其实是同一套：
- 从浏览器 Cookie 里取
yuque_ctoken，确认登录态存在。 - 请求语雀的“最近使用”接口，拿到默认知识库 ID。
- 用这个知识库 ID 建一篇草稿文档，拿到文档 ID。
- 正文里的外链图片逐张下载，重新上传到语雀自己的图床，替换成新链接。
- 把 Markdown 提交给语雀的格式转换接口，转成语雀私有的 Lake 富文本格式。
- 保存正文；如果不是只存草稿，再调一次发布接口把状态改成已发布。
这条路不用申请 Token，也就不卡“超级会员”或“旗舰版空间”这道门槛，用的是你本来就有的登录身份，权限跟你在网页上手动操作时完全一样。你在网页上能发到哪个知识库，这条路也只能发到那个知识库，不会绕过你账号本身的权限范围。
两条路放在一起怎么选
| 维度 | 官方开放 API | 本地登录态直接发布 |
|---|---|---|
| 权限门槛 | 个人需超级会员，团队需旗舰版空间 | 无额外付费门槛，用现有登录身份 |
| 要不要自己写代码 | 要，自己对接 v2 接口 | 不用，AI 直接发发布指令 |
| 图片处理 | 需自己实现上传转存逻辑 | 自动下载外链图片并转存到语雀图床 |
| 能发到哪些知识库 | 取决于 Token 授权范围 | 跟你网页手动操作时的权限范围一致 |
| 典型使用者 | 已有开发资源的团队，做深度系统集成 | 个人创作者、想用 AI 直接执行发布的团队 |
怎么选：如果本来就要搭一套跨系统的自动化流水线（比如语雀更新联动 CI、联动飞书通知），官方 API 更适合，前提是愿意为对应会员或空间套餐付费。如果只是想让 AI 按你的指令把稿子发进语雀，不想额外开会员也不想自己写对接代码，本地登录态这条路更直接。
具体怎么做
- 下载 PublishPort 客户端，用它管理的 Chrome 登录一次语雀，正常走一遍登录流程即可，不需要额外操作。
- 把要发的内容整理成 Markdown 文件，图片可以先用外链占位——发布时会自动转存到语雀图床。
- 让接入的 AI 执行发布指令，等价于命令行的
ppcli yuque article "标题" --file draft.md --execute（不加--execute只会做空跑检查，不会真的写入）。 - 想先看效果不想直接发布，加
--draft只存草稿，人工打开确认排版没问题再手动点发布。 - 命令跑完会返回文档 ID 和编辑页链接，用来核对内容是不是真的落进了对的知识库。
webhook 和“自动发布”是两回事，别搞混
语雀知识库设置里有个“自动发布”开关，还有个“消息推送”里的 webhook 配置，很多人以为开了自动发布就能顺带拿到更新通知，社区里反复被记录的实际情况是——知识库一旦勾选了自动发布，文档更新反而不会触发 webhook 推送。想用 webhook 联动别的系统（比如同步生成静态博客），得先把自动发布关掉。这两个功能是互斥关系，不是叠加关系，配置前先想清楚自己到底要哪一个。
边界与注意
- 语雀的 Lake 是私有富文本格式，官方没有提供把 Lake 内容迁出到其他笔记软件的工具。Markdown 转 Lake 是发布方向的单向转换，思维导图这类语雀专属组件不在 Markdown 能表达的范围内，复杂排版建议先
--draft存草稿人工检查一遍再发布。 - 写操作默认需要显式加
--execute才会真正提交，就是为了防止脚本误跑把草稿当正式发布提交出去。 - 图片转存依赖能正常访问原图链接，外链图片失效或被防盗链拦截时会转存失败，命令返回结果里会列出失败清单，需要人工补传。
- 不管走开放 API 还是本地登录态，语雀官方都保留识别异常行为并限制账号的权利，没有工具能承诺绝对不触发。按你平时正常写作、发布的节奏用，是唯一靠谱的边界。
语雀自动发布检查清单
- 已经在同一个 Chrome 里正常登录过语雀（不是无痕窗口）
- 正文是 UTF-8 编码的 Markdown 文件
- 复杂排版（表格、思维导图、多层嵌套列表）先
--draft存草稿人工核对 - 确认目标知识库就是“最近使用”里排第一的那个，需要发到别的知识库要单独确认
- 图片链接可以被外部正常访问，不是内网或需要登录才能看的地址
常见问题 / FAQ
语雀有没有官方的自动发布功能？
没有“从本地 Markdown 文件一键发布”这种官方功能。官方提供的是网页手动建文档，以及需要申请 Token 的开放 API；知识库里的“自动发布”开关管的是文档编辑后是否自动进入已发布状态，跟“自动从外部导入发布”是两回事。
语雀 API Token 怎么申请，需要花钱吗？
在个人设置的 Token 页面申请，但官方文档标注个人 Token 是超级会员专享权益，团队 Token 需要旗舰版空间套餐，两者都要先开通对应付费档位才能看到申请入口，具体价格以语雀官方定价页为准。
不用 API Token，还能自动发布到语雀吗？
可以，复用浏览器里已登录的语雀会话去调用网页本身在用的接口，不用单独申请 Token 或开通会员，权限跟你手动操作时一样，只能发到你账号本身有权限的知识库。
AI 能直接把文章发布到我的语雀知识库吗？
能，前提是 AI 能拿到一个已登录语雀的浏览器会话去执行发布指令。PublishPort 这类工具让 AI 通过你本机的登录态调用发布命令，AI 自己不持有你的账号密码，也不会绕开你账号原有的权限范围。
语雀文章能不能自动同步发布到公众号、知乎这些平台？
方向反过来了：市面上文章同步助手这类工具，主流做法是把内容同步进公众号、知乎、CSDN 等平台，很少有工具专门做“从语雀往外发”。如果是想反过来，用同一份 Markdown 稿子分发到多个平台，需要针对每个目标平台单独走对应的发布路径，可以参考技术博客一稿多发这篇里对 CSDN、掘金这类平台的具体处理方式。
Markdown 发到语雀会不会丢格式？
常规的标题、加粗、代码块、列表、图片都能正常转换。语雀专属的组件比如思维导图，Markdown 语法里本来就没有对应写法，没法自动生成；复杂表格和多层嵌套结构建议先存草稿人工核对一遍排版，确认没问题再正式发布。