富文本编辑器

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

核心能力(可验证事实)

能力 说明
工具栏排版 标题层级、列表、链接、图片、表格、代码块、分隔线;全屏编辑与手动/自动保存
页内 TOC(v1.22+) 编辑长文时右侧大纲导航,点击跳转至文内标题锚点
Markdown 编辑块(v1.22+) 工具栏插入纯 Markdown 块,可粘贴外部 AI 生成的 MD 而不破坏块结构
分栏 bke:columns 多栏并排(如 count=2layout="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 精确引用。

相关操作