把Markdown 发到云+社区：我踩了十几次才摸清的隐藏规则

Markdown 发到云+社区：我踩了十几次才摸清的隐藏规则

很多人以为，把一篇写好的 Markdown 文章直接粘贴到云+社区（腾讯云开发者社区）就能发。我也这么以为，结果三篇文章来回改了十几次：要么发布按钮点不动，要么审核被拒，报错还经常指不到真正的根因。

这篇经验贴把全部坑一次说清，照着做可以少走弯路。

一、编辑器有两种模式，选错全白搭

云+社区默认是富文本编辑器。如果你在富文本模式下粘贴 Markdown，平台会把 Markdown 当成纯文本塞进去，标题、列表、代码块全变成一坨文字。审核系统看到这种内容，会判"格式有误"或"内容不全"。

正确做法：进编辑页后，先点"切换到 Markdown 编辑器"。切过去之后，正文区是 Monaco（和 VS Code 同款），这时粘贴 Markdown 才正常。

二、代码块必须带语言标签

这是第一个硬校验。围栏代码块如果写成裸的三反引号：

平台会弹"文中第N处代码段未配置语言，请补全后再操作"，发布直接被拦。

修复很简单：每个代码块开头都写上语言，比如 text**、**javascript、bash**。哪怕只是示意文本，也用 **text 兜底。

三、最隐蔽的坑：内联反引号也算代码段

这是和 GitHub、掘金等平台最大的不同。云+社区不仅校验围栏代码块，连正文里行内的反引号也当成"代码段"来检查。

比如你想写"导出文件名前缀是 YYYY-MM-DD_ 这样的格式"，如果写成反引号包裹：

它也会被算作"未配置语言的代码段"，照样拦发布。

修复方式：把所有行内反引号改成粗体。上面那句就写成：YYYY-MM-DD_。自我检查的办法：在编辑器页面打开控制台，执行下面这句，结果必须是 0 才能过前端校验：

四、被拒"广告/引流"？先查这个开关

三篇文章里，有两篇反复被拒，原因都是"内容包含广告/引流信息"。我先后删了品牌标签、改了正文、清了摘要，还是不过。最后才发现真正的元凶根本不在正文里。

云+社区文章设置里有一个选项，叫"开启产品关键词自动添加超链接"。只要勾上，平台就会自动把正文里的产品名、技术名词转成指向腾讯云产品页的超链接。AI 审核扫到这些自动插入的外链，就判定为广告引流。

这个开关默认可能就是开的，而且它不在正文、不在标签、不在摘要，肉眼完全看不出来。

正确做法：发布前，进"文章设置"，把"开启产品关键词自动添加超链接"关掉。关掉之后，那两篇之前屡拒不过的文章立刻就发成功了。

五、标签栏别放品牌名

标签本身是给文章归类用的，但如果放了具体产品名或品牌名（比如某个 AI 编程助手、某个云产品的名字），也会被算作引流。

正确做法：标签只用通用技术词，例如 API、自动化、爬虫、前端、部署。把具体的产品品牌名清空。

六、发布前自检清单

照着这九条过一遍，基本一次过：

1. 编辑器切到 Markdown 模式（非富文本）。
2. 每个围栏代码块都带语言标签。
3. 正文没有行内反引号，行内代码都改成粗体。
4. 标签栏清空品牌名，只留通用技术词。
5. 文章设置里关闭"产品关键词自动添加超链接"。
6. 标题、摘要不含产品名和外链。
7. 用 Monaco 的 setValue 写内容，别直接改文本框（直接改平台读不到）。
8. 改完按 Ctrl+S 保存，确认标题栏的星号消失。
9. 最后一步"确认发布"按钮，需要真人用鼠标点，脚本点不动。

七、用脚本辅助检查

如果你习惯用浏览器调试端口做自动化，可以写一个 CDP 脚本连上已登录的编辑页，自动审计上面这些项并修复。有两个技术点容易踩：

一是 CDP 的返回值嵌套在 result.result.value 里，不是一层。二是消息分发不能用一次性监听，因为平台会持续推各种事件把你的响应冲掉，得用按 id 精确匹配的映射表。

脚本适合做"审计 + 修复 + 保存"，但最后的"确认发布"必须人来点——这是平台故意的前端限制。

总结

云+社区发布不是"粘贴即所得"。真正卡住人的就两件事：代码段（含行内反引号）的语言标签校验，以及那个隐蔽的"产品自动链接"开关。把这两点记住，大部分发布问题都能提前避开。