张月鹿图文发布测试
适用场景
本文用于验证 StreamX 网站后台发布图文内容时，Markdown 正文、相对图片路径和中英文内容是否能正常同步与展示。示例图片来自测试素材，不代表正式运营内容。
适合在以下场景使用：
- 检查博客或帮助中心文章中的首图是否能正常加载。
- 验证正文中图片说明、列表和步骤排版是否稳定。
- 发布前确认中英文版本的信息结构保持一致。
前置条件
- 已准备好要发布的图文内容。
- 图片文件已放入当前文档的
assets文件夹。 - Markdown 中使用相对图片路径，例如
/help-assets/blog/blog/test-blog-zhenyuelu/assets/zhenyuelu.jpg。 - 同步到网站前，确认测试内容不会包含真实账号、Token、邮箱、手机号或其他敏感信息。
操作步骤
- 打开 StreamX 后台。
- 进入内容管理页面。
- 新建一篇内容类型为博客或帮助中心文档的文章。
- 填写标题、摘要和正文。
- 在正文中插入图片，并保留相对路径。
- 保存草稿后预览中文版本。
- 切换到英文版本，确认英文正文结构与中文一致。
- 确认图片、标题和段落排版正常后，再执行发布。
图文检查
图片应显示在正文开头，用于确认首图加载、宽度适配和移动端展示效果。正文段落应保持清晰的层次，不应与图片、标题或列表发生重叠。
发布后重点检查：
- 图片是否加载成功。
- 图片下方正文是否紧跟且间距正常。
- 列表项是否按 Markdown 结构渲染。
- 中文页面和英文页面是否都能打开。
常见问题
图片没有显示怎么办？
先检查图片是否在当前文档的 assets 文件夹内，再检查 Markdown 图片路径是否为相对路径。不要在源文件中直接写服务器绝对路径。
可以把图片放在其他文档目录吗？
不建议。每篇文档应使用自己的 assets 文件夹，便于同步、删除和回滚。
测试内容发布后是否可以保留？
如果只是验证同步链路，测试完成后应在后台撤回或删除，避免影响正式网站内容。
注意事项
- 本文是测试内容，不作为正式产品教程。
- 图片路径必须保持为
/help-assets/blog/blog/test-blog-zhenyuelu/assets/zhenyuelu.jpg。 - 发布前必须先同步图片资源，再同步 Markdown 正文。
- 修改图片文件名后，需要同步更新中文和英文 Markdown 引用。