华为云社区写博客实操:两种编辑器的差异、静默失败的坑与发表前必检项

举报
明yd_241851832 发表于 2026/11/11 00:56:16 2026/11/11
【摘要】 记录一次完整的博客发表过程:富文本 TinyMCE 与 Markdown 代码编辑器两种模式的差异、字数统计不同步的原因、免责声明不勾选导致发表无反应、账号昵称与协议检查,以及超链接白名单和提交后的核实方式等注意事项。

一、入口和两种编辑器

从华为云社区博客列表页右上角点「写文章」进入编辑页。页面顶部提供「富文本格式编辑」和「Markdown 格式编辑」两种模式,并明确提示:文章内容当前仅支持单一类型编辑器下编辑发布。也就是说一篇稿子从开写到发布要固定用一种模式,中途来回切换容易出问题。

富文本底层是 TinyMCE(页面上能看到 tox 系列容器),正文放在一个 contenteditable 的 iframe 里;Markdown 模式则是代码编辑器。两者的「内容状态」管理方式完全不同,这也是后面几个坑的根源。

二、富文本:写入内容后字数统计没变

用脚本或调试方式把 HTML 塞进编辑器后,界面上正文已经完整显示,但底部字数统计仍停在 0/100000。原因是统计组件监听的是编辑器的输入类事件,单纯调用 setContent 不会自动触发这层同步。补发 change、keyup、NodeChange 等事件后,统计立刻更新为实际字数。

这一点在排查「明明有字却提交失败」时很关键:不要只看界面,还要看统计器和编辑器实例取回的内容长度是否一致。

三、Markdown:有字却被判「正文不能为空」

Markdown 模式基于代码编辑器,内容由编辑器内部状态维护。如果只是把文本写进 DOM 元素,视觉上能看到字,但编辑器状态没被记录,提交时就会被判空并提示「博客正文内容不能为空」。老实用键盘输入或粘贴才会走正常的输入链路。

四、发表前的必填项和最容易漏的一项

项目 限制与说明
标题 不超过 64 个字符,不能全是空格
摘要 不超过 200 字;留空时默认取正文前 200 字
标签 平台按内容自动匹配,可在此基础上修改
专栏 可选
创作类型 原创 / 翻译 / 转载,默认是「原创文章」
是否允许转载 默认允许,可改为不允许
评论权限 可设置文章不需要评论
声明 免责声明,必须勾选

最容易漏的就是最后一行。免责声明不勾,点「发表」完全没有任何反应,既不弹错误也不跳转,属于非常安静的失败;反过来,标题为空、正文为空、摘要超长这类校验失败时,页面还会把已经勾上的声明自动取消掉。所以看到按钮「点不动」,先看声明有没有勾上。

五、发表动作背后还有账号检查

「发表」并不是直接提交表单,链路大致是:检查账号是否已签署开发者相关协议、检查个人信息与昵称状态、校验标题正文摘要、组装内容数据、最后提交。如果昵称还没设置过,会弹「设置昵称」框(长度不超过 10 个汉字或 20 个英文字符,设置后 3 个月内不可修改),这一步做完才能继续。

另外,正文里如果出现裸 URL,编辑器会自动把它识别成超链接,提交时可能提示「超链接不在白名单中」。把地址放进代码块或行内代码里,就不会被当成可点击链接。

六、提交之后

提交成功后页面不一定跳转到明显的成功页,但博客已经生成:在「我的博客」里能看到新条目和发布时间,详情页也有独立编号。建议发表后去「我的博客」核一次,而不是只看编辑页有没有反应。内容会经过社区审核,真实的操作复盘、具体的步骤和配置片段通过率更高,凑字数的水文容易被打回。

小结

  • 一篇稿子固定用一种编辑器,不要中途切换;
  • 界面有字不等于编辑器状态有内容,看字数统计和取回内容;
  • 免责声明必勾,昵称与协议检查要放行;
  • 裸 URL 放进代码块;
  • 发表后去「我的博客」核实,别以编辑页的反应为准。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。