Question
Closed · Answered

Busa CMS 的文章通过 API 读出来,标题和图片格式怎么保留?

Jen

网站要读取审核通过的文章,正文里有小标题、链接和图片。用 API 取到内容后,怎样渲染才不容易丢格式?有没有推荐的字段设计或现成示例?

Report
lanziwen
Team

标准 Busa CMS 模板 已把常用字段分开:

  • 标题(title):作为文章页主标题。
  • 正文(body):Markdown,保存小标题、链接和行内图片。
  • 封面图片(cover-image):单独展示,不等于正文图片。
  • 附件(attachments):作为附件列表;添加附件不会自动把它插入正文。

例如正文可以这样写:

## 使用步骤

查看[详细说明](https://example.com/guide)。

![操作示意图](https://example.com/images/guide.png)

网站把这段交给安全的 Markdown 渲染器,就能显示小标题、可点击链接和图片。建议用二级、三级标题组织正文,主标题由文章页单独显示。图片要使用访客能访问的 HTTPS 地址,不要使用本机路径或只在编辑者登录后才能访问的地址;也不要为了显示图片,直接公开整个内部工作区。

已有 CMS SDK 和可运行的 Next.js 示例。示例文章页使用 SafeMarkdown 渲染 post.body,标题、封面和附件分别处理,API key 留在服务端,不交给浏览器。Markdown 不应当作可执行的 MDX;如果使用 Pages 的 HTML 正文,则要先做安全清理再展示,不能和 Posts 的 Markdown 混用。

Report

Your reply

Sign in to join the discussion. Reading is always open; you only need an account to post.

Sign in