这一段是 text 块,用来写正文。段落里想换行就写 \n,不会解析 Markdown 或 HTML —— 这是刻意的,正文结构由块型表达,不引入「谁来消毒 HTML」这个问题。
先说结论
整篇文章就是一个数组,一个元素就是一块。顺序即呈现顺序,想调位置直接挪数组里的位置。步骤块:照着做的事情用它
steps 会渲染成带序号的竖列,读的人能对着一步步走。这是教程里最常用的一块。
- 1
在管理后台「知识库」新建一篇文章。
- 2
填写标题、slug、分类与摘要。
- 3
在正文 JSON 里按块型编辑 body 数组。
- 4
保存并上架,前台 /kb 与详情页即时可见。
要点块:记住就行的事情用它
list 是无序的小圆点,steps 是有序的序号 —— 两者不要混用。
slug 定下来就别改,改一次所有发出去的链接就断了。
updatedAt 改内容时记得一起改,读的人靠它判断这篇还能不能信。
命令块:要抄的东西用它
bash
npm install
npm run dev
# 然后打开 http://localhost:3002/kb本地把站跑起来
提示
图片与视频素材可放在前台 public/kb/ 目录,正文块里填写 /kb/xxx.png 等站内路径。