Files
NotesAgentic/docs/development/Markdown渲染检查.md
T

3.6 KiB
Raw Blame History

Markdown 渲染检查

日期:2026-09-05。范围为当前工程启用的 CommonMark、GFM、Milkdown Crepe 扩展及静态 Markdown 预览,不代表所有 Markdown 方言。

本次修复

  • 行内代码:保留普通输入规则,为绕过 handleTextInput 的浏览器文本输入与输入法组合结束增加单反引号补偿处理。跳过代码节点、已有代码标记、转义反引号;不改写文件中的转义文本。同时识别先输入空反引号对、再移入填字的路径,并在转换后保留继续输入的代码标记;空反引号对序列化时的转义不会阻断识别。回归测试覆盖缺失事件数据、替换文本、延迟组合结束与粘贴/撤销排除。独立浏览器编辑器已实测逐字输入、段落/行内换行,以及先输入反引号对再向中间填入 s。
  • 工具栏:未选中文字时,行内代码按钮可切换后续输入的代码标记;此前上游命令在空选区直接返回。
  • 样式:工作区与静态预览使用主题代码背景、文字及边框变量,避免行内代码与正文难以区分。
  • 静态预览:补齐 $...$$$...$$ 和编辑器保存的 LaTeX 围栏公式;代码中的公式符号保持原文。公式使用 KaTeX,禁用可信 HTML 命令并经过最终清理。
  • 静态表格:恢复 GFM 中间、右侧对齐,避免通用单元格样式覆盖对齐属性。

检查矩阵

格式 工作区编辑 静态预览 验证
H1H6 标题节点 标题元素 新增格式矩阵
粗体、斜体、删除线 标记渲染 strong / em / del 新增格式矩阵
单反引号、多反引号代码 行内代码;保存保留定界符 code,转义内容不执行 加载、普通键入、组合输入、工具栏与序列化
有序、无序、嵌套列表 列表节点 ol / ul 新增格式矩阵
任务列表 GFM 任务项 禁用复选框 格式矩阵及 GFM 输出
引用、分割线 原生节点 blockquote / hr 新增格式矩阵
链接、引用式链接、图片 Crepe 原生组件 安全链接及图片 静态格式矩阵;图片实际加载受路径可访问性影响
GFM 表格 表格组件 table;主题边框和对齐 格式矩阵、对齐规则检查
硬换行、转义符 编辑器保留 Markdown 语义 br / 转义文本 静态格式矩阵
围栏代码、未知语言 CodeMirror / Shiki Shiki;未知语言回退纯文本 既有语言测试与新增回退测试
行内、块级数学公式 Crepe LaTeX KaTeX 编辑器格式矩阵与新增静态公式测试
Mermaid 图形预览 SVG 图形 既有主题、错误回退、大图文字及缩放测试
YAML 元数据 独立属性栏 普通 Markdown 场景不视为属性表单 既有标题、标签、引号、锚点、编码与往返测试
自定义字号 span 装饰渲染 清理后 HTML 既有字号标记测试
原始 HTML 编辑器按自身 HTML 节点规则保留 清理后展示,脚本及事件属性移除 新增安全 HTML 测试

源码模式展示 Markdown 原文,不隐藏反引号、星号和围栏。脚注、定义列表、Wiki 双链、Obsidian callout、图表以外的自定义围栏等未作为独立渲染扩展启用,不在“已支持”范围内。

自动检查覆盖解析、DOM 输出、部分编辑交互、保存往返和主题变量。尚未完成所有浏览器、所有输入法及每个主题的逐页截图比对;不能据此宣称像素级视觉验收通过。测试使用隔离样例,没有修改用户笔记。