新手入门

示例:这篇文章演示了全部正文块

这是一篇模板文章,把知识库支持的八种正文块各用了一遍。照它改字就是你的第一篇教程,不需要的块删掉即可。

更新于2026-09-033 分钟

这一段是 text 块,用来写正文。段落里想换行就写 \n,不会解析 Markdown 或 HTML —— 这是刻意的,正文结构由块型表达,不引入「谁来消毒 HTML」这个问题。

先说结论

整篇文章就是一个数组,一个元素就是一块。顺序即呈现顺序,想调位置直接挪数组里的位置。

步骤块:照着做的事情用它

steps 会渲染成带序号的竖列,读的人能对着一步步走。这是教程里最常用的一块。

  1. 1

    在管理后台「知识库」新建一篇文章。

  2. 2

    填写标题、slug、分类与摘要。

  3. 3

    在正文 JSON 里按块型编辑 body 数组。

  4. 4

    保存并上架,前台 /kb 与详情页即时可见。

要点块:记住就行的事情用它

  • list 是无序的小圆点,steps 是有序的序号 —— 两者不要混用。

  • slug 定下来就别改,改一次所有发出去的链接就断了。

  • updatedAt 改内容时记得一起改,读的人靠它判断这篇还能不能信。

命令块:要抄的东西用它

bash
npm install
npm run dev
# 然后打开 http://localhost:3002/kb

本地把站跑起来

提示

图片与视频素材可放在前台 public/kb/ 目录,正文块里填写 /kb/xxx.png 等站内路径。

按这篇做还是卡住了?

把卡在第几步告诉客服,我们直接帮你看

Telegram@chejiu99