富文本编辑器
巴克励步
知识库使用的 文档编辑器(Baklib Editor) 在 GFM Markdown 之上扩展 块级组件 与行内属性,兼顾可视化排版与 Markdown 互操作。Wiki 类文档的正文撰写、版本保存与发布均依赖 文档编辑器;CMS 类应用在页面管理中使用模板化编辑器,能力模型不同。

核心能力(可验证事实)
| 能力 | 说明 |
|---|---|
| 工具栏排版 | 标题层级、列表、链接、图片、表格、代码块、分隔线;全屏编辑与手动/自动保存 |
| 页内 TOC(v1.22+) | 编辑长文时右侧大纲导航,点击跳转至文内标题锚点 |
| Markdown 编辑块(v1.22+) | 工具栏插入纯 Markdown 块,可粘贴外部 AI 生成的 MD 而不破坏块结构 |
分栏 bke:columns |
多栏并排(如 count=2、layout="1:1"),适合对比说明与图文并列 |
标注框 bke:callout |
提示、注意、警告等强调段落 |
链接卡片 bke:link-card |
站内/站外链接渲染为卡片,可带描述 |
知识片段 bke:fragment |
嵌入 DAM 可复用片段,dam-id 引用主版本正文 |
图片与 dam-id |
上传自动入库资源库;行内属性支持对齐等 |
| iframe / 视频嵌入 | 独占段落的网页或视频嵌入语法 |
| AI 翻译(v1.28+) | 编辑器右上角 整篇翻译 与 划词翻译,尽量保留块级结构;知识片段引文不随正文翻译而改写,多语言须维护片段版本 |
| AI 生成 MD 同步(v1.35 优化) | 外部生成的 Markdown 可更顺畅导入在线编辑器 |
为什么需要
结构化 文档编辑器 正文同时服务 人类阅读、站内搜索索引、页面
.md / llms.txt 输出 与 MCP 写入。块级语义清晰的长文比纯 HTML 粘贴更利于 AI Ready 与协作审校。边界与限制
- 文档编辑器 用于 知识库;CMS 页面编辑见应用库专章,二者工具栏与存储模型不完全相同。
- API / MCP 写入须声明
body_type: markdown,否则bke:块可能按纯文本存储。 - AI 翻译产出须人工审校术语与合规表述;不会替代多语言站点发布流程。
- 阅读模式与编辑模式分离;历史版本与导出能力以当前产品界面为准。
与谁组合
- AI 翻译:多语言帮助中心初稿。
- AI Ready:文档编辑器 结构影响
.md端点可读性。 - 内容复用 / 知识片段:
bke:fragment与 DAM 片段联动。 - 资源库:图片上传自动入库,编辑时按
dam-id精确引用。