@yungu-fed/rich-text-editor 0.1.10 → 0.1.11

package/README.md

@@ -80,6 +80,21 @@ markable，以及如何插入、渲染、normalize 和通过 codecs 转换。完
 仅包含 HTML 的网页富文本和编辑器内部复制继续保留原格式。
 
 支持标题、有序/无序列表、加粗、斜体、删除线、行内代码、分隔线、图片和表格。
-图片复用现有上传流程。代码块转换为保留换行的代码文字，引用保留内容但不保留引用样式。
-链接保留 Markdown 原文及地址，暂不生成可点击链接；不解析公式扩展和内嵌 HTML。
+图片复用现有上传流程。代码块转换为带工具栏、行号和语法高亮的代码卡片，保留语言、缩进和换行，引用保留内容但不保留引用样式。
+支持 `$…$`、`$$…$$`、`\(...\)` 和 `\[...\]` 数学公式，使用 Root 的公式渲染配置，
+独立段落中的公式保留段落结构，行内公式嵌入正文；代码内的公式语法不转换。
+链接保留 Markdown 原文及地址，暂不生成可点击链接；不解析内嵌 HTML。
 转换后的内容仍存储为现有 Slate JSON，可使用撤销恢复粘贴前的内容。
+
+## 代码块
+
+通过 `RichTextEditor.Toolbar.CodeBlockButton`、`api.insertNode('code-block')` 或粘贴
+Markdown 代码围栏插入代码块。代码卡片提供标题、语言、浅色/深色主题、复制和删除操作，统一使用默认等宽字体。
+支持 JavaScript、TypeScript、Python、JSON、HTML/XML、CSS、SQL、Shell；未知语言按纯文本显示。
+Enter 保留当前行缩进，Tab / Shift+Tab 缩进/取消缩进；Ctrl/⌘+Enter 或“退出代码块”进入后续普通段落。
+代码块内部粘贴按原文插入，不再执行 Markdown 或公式转换。
+
+代码保存在 `children` 中，`title`、`language`、`theme` 为节点属性；高亮 token
+仅存在于视图中。HTML 输出包含静态卡片、行号及高亮，复制代码仅复制原文。
+旧 `code-block` 缺省属性使用纯文本、浅色主题与默认字体；旧段落上的行内 code 标记不自动迁移。
+折叠、拖拽、调整尺寸、评论和 IDE 补全不包含在此版本中。