MarkText 内核解析深入剖析 muyajs 中基于 Marked.js 定制改造的 Markdown 解析器【免费下载链接】marktextA simple and elegant markdown editor, available for Linux, macOS and Windows.项目地址: https://gitcode.com/gh_mirrors/ma/marktextMarkText 仓库中的packages/muyajs是其旧版 JavaScript 内核muya 的前身其中lib/parser/marked目录内嵌了一份经过深度定制的 Marked.js 解析器。本文以 packages/muyajs/lib/parser/marked/README.md 为骨架结合目录下的全部源码与调用方实现完整讲解这份定制解析器的版本基线、扩展功能frontmatter、数学公式、emoji、Lexer/Renderer 改造细节以及它在 MarkText 的导入import、导出export和复制粘贴链路中的真实用法。读完本文你将理解 MarkText 如何让一个第三方 Markdown 引擎同时服务于“编辑器内容状态构建”与“HTML 导出渲染”两条完全不同的消费管线。一、版本基线v0.8.2 v1.2.5 补丁的混合体根据 README.md 的说明该目录中的 Marked.js 补丁版本基于两点主体基于v0.8.2的代码结构合入了v1.2.5中的 bug 修复刻意不包含 v1.0.0 以来的任何破坏性变更no breaking changes fromv1.0.0。这意味着它保留了 v0.8.x 时代new Lexer(...).lex(src)→new Parser(...).parse(tokens)的经典三段式 API同时吸收后续版本对已知缺陷的修复。这一点在源码中可以得到印证index.js 的入口函数marked(src, opt)仍是new Parser(opt).parse(new Lexer(opt).lex(src))并保留了silent模式下返回错误 HTML 片段、否则抛异常的行为但同时inlineLexer.js 中已包含 CommonMark 风格的“匹配尖括号链接”与findClosingBracket处理这些属于较新版本引入的修复逻辑。从代码注释看这份解析器长期服务于 MarkText 的旧内核muyajs许多补丁都直接关联 MarkText 的 issue例如 blockRules.js 中针对有序列表)分隔符的补丁对应 marktext issue #831以及任务列表独立成列表的解析对应 issue #870。二、目录结构一份可独立运行的解析器该目录共 13 个文件构成完整的 Markdown → HTML 解析管线文件职责index.js对外入口marked(src, opt)默认导出函数同时导出Renderer、Lexer、Parseroptions.js全部默认配置项标准项 MarkText 扩展项blockRules.js块级语法规则含 frontmatter、multiplemath 等扩展规则inlineRules.js内联级语法规则含 emoji、math、上下标、脚注引用lexer.js块级 LexerMarkdown 文本 → token 流inlineLexer.js内联 Lexertoken 文本 → 内联 HTMLparser.js按 token 类型驱动各 Renderer 方法输出 HTMLrenderer.js默认 HTML Renderer含全部扩展方法textRenderer.js纯文本 Renderer用于抽取标题纯文本生成 slug/目录slugger.js标题 id 生成slugutils.js正则编辑工具、转义、URL 清洗等urlify.js链接文本 URL 化辅助LICENSEMIT 协议此外还有parser/marked的同级模块 parser/rules.jsMarkText 自研的内联规则集通过findClosingBracket复用了 marked/utils.js 的工具函数说明该目录同时也被当成通用工具库使用。三、配置项全景标准选项与 MarkText 扩展选项options.js 是理解这份解析器行为的钥匙全部默认值如下继承自上游 Marked.js 的标准选项选项默认值含义baseUrlnull相对链接解析的基准 URLbreaksfalse是否把单个换行渲染为brGFM 变体规则gfmtrue启用 GFM 语法表格、删除线、扩展自动链接等headerIdstrue是否给标题生成id锚点headerPrefix标题 id 前缀highlightnull代码高亮回调返回非空且不同于原文时按高亮结果输出langPrefixlanguage-代码块语言 class 前缀mangletrue对自动链接的邮箱做字符实体混淆pedanticfalse严格遵循 Gruber 原始松散规范silentfalse解析出错时静默返回错误 HTML 而非抛异常smartListsfalse是否允许“智能列表”不同 bullet 标记合并为同一列表smartypantsfalse智能标点转换---→破折号、...→省略号等xhtmlfalse是否输出 XHTML 风格自闭合标签sanitize/sanitizerfalse/null已废弃的净化选项源码注释明确建议不要使用MarkText 扩展选项README 所述三大特性的开关选项默认值含义disableInlinefalse内联解析禁用模式见第四节emojitrue是否解析:emoji:语法mathtrue是否解析行内$...$与块级$$...$$数学公式frontMattertrue是否解析文件开头的 frontmatter 元数据superSubScriptfalse是否解析上标^x^与下标~x~footnotefalse是否解析脚注[^id]isGitlabCompatibilityEnabledfalse是否兼容 GitLab 风格显示数学math 围栏isHtmlEnabledtrue是否允许 HTML 标签mathRenderer/emojiRenderer/tocRenderernull注入式自定义渲染回调见第六节代码注释透露了一个设计意图源码中标注 “TODO: We set whether to support emoji, math, frontMatter default value to true / After we add user setting, we maybe set math and frontMatter default value to false”即这些扩展开关未来应下沉到用户设置中控制。四、Lexer 定制disableInline 模式与自定义列表解析README 将 Lexer 层面的改动归纳为四类逐一对应源码4.1disableInline面向“编辑器状态构建”的专用模式这是 MarkText 为编辑器场景引入的关键开关。当disableInline: true时inlineLexer.js 的output()直接返回escape(src)即跳过一切内联语法解析仅做 HTML 转义。它的意义在于编辑器导入 markdown 时只需要“块级结构”标题、列表、代码块、表格、引用内联内容要交给 MarkText 自己的 tokenizer 按光标位置精确切分见 parser/index.js 的tokenizerFac。若在构建块结构时就把内联语法吃掉光标定位和增量编辑就会失真。与此同时lexer.js 在disableInline下会把引用定义def也作为普通段落 token 输出避免定义文本被吞掉。4.2 基于旧版 Marked.js 的自定义列表实现lexer.js 的注释明确写着“Complete list lexer part is a custom implementation based on an older marked.js version”。这份自定义实现比上游 v0.8.2 提供了更丰富的 token 信息list_starttoken 携带ordered是否有序、listTypeorder | task | bullet和start有序列表起始数字每个list_item_starttoken 携带checked任务项勾选状态undefined表示非任务项、listItemType与bulletMarkerOrDelimiterREADME 所说的 “more token information like list item bullet type”使用loose_item_start/list_item_start区分宽松列表项间有空白行与紧凑列表供编辑器还原loose属性。解析时还实现了 CommonMark 264/265 规则bullet 标记变化-→*、有序列表分隔符变化.→)、有序/无序切换、任务项与普通项切换都会分裂成新列表lexer.js并且任务列表被刻意处理为独立列表类型对应 MarkText issue #870。4.3 更多 token 元信息与前后端一致除列表外Lexer 还丰富了其他 tokenheading带headingStyle: atx | setext、code带codeBlockStyle: indented | fenced与lang、hr带原始marker、frontmatter token 带lang与style。这些元信息让 Renderer 与编辑器都能区分语法来源。4.4 光标签名保护cursor signaturelexer.js 从 config/index.js 引入两个随机长 IDCURSOR_ANCHOR_DNA、CURSOR_FOCUS_DNA当编辑器在文档中插入光标占位符anchor/focus时若该占位符位于行首会破坏块级解析。Lexer 在checkCursorSignature开启时会把占位符先剥离、标记再在输出 token 文本时原样回填如cursorAnchorFocus text确保含光标占位符的文档仍能被正确解析。五、Features 详解一frontmatterYAML/TOML/JSON5.1 语法规则blockRules.js 定义了frontmatter正则支持四种包裹符分隔符格式langstyle--- ... ---YAMLyaml- ... TOMLtoml;;; ... ;;;JSON分号风格json;{ ... }JSON花括号风格json{对应地lexer.js 在frontMatter开启且位于文件最开头top且checkFrontmatter时匹配产出{ type: frontmatter, text, style, lang }token。注意checkFrontmatter在第一次匹配尝试后即置为false确保 frontmatter 只在文档头部被识别。5.2 渲染输出renderer.js 的frontmatter()输出pre classfront-matter {text} /pre即渲染为带front-matterclass 的pre块方便主题样式化。5.3 编辑器侧消费在 importMarkdown.js 中frontmattertoken 被还原为pre→code→span三层块结构lang与style原样保存前端再据此按 YAML/TOML/JSON 分派高亮与编辑行为。六、Features 详解二数学公式inline math 与块级 multiplemath6.1 语法规则行内公式inlineRules.js 的math: /^\$([^$]*?[^\$\\])\$(?!\$)/即$...$单美元包裹且刻意排除$$以免与块级冲突块级公式blockRules.js 的multiplemath: /^\$\$\n([\s\S]?)\n\$\$(?:\n|$)/即$$独占一行的包裹GitLab 兼容模式isGitlabCompatibilityEnabled开启后lexer.js 额外匹配 math 围栏multiplemathGitlab规则产出mathStyle: gitlab的multiplemathtoken。6.2 渲染输出与 katex 注入renderer.js 的multiplemath()与inlineMath()遵循“优先回调、失败回退”策略若配置了mathRenderer则调用mathRenderer(text, displayMode)块级displayMode true行内为false无回调或返回空串时块级公式回退为pre classmultiple-math行内公式直接回退为原始文本。在真实导出链路 exportHtml.js 中mathRenderer被实现为KaTeX 的renderToString(math, { displayMode })当公式非法时输出带invalidclass 的占位节点并记录mathRendererCalled标志用于决定是否向最终 HTML 注入katex.css见 exportHtml.js。这也解释了“非破坏性修补”的设计默认配置下 math 渲染为空MarkText 通过选项注入真正的公式引擎而不改动解析器本体。七、Features 详解三emoji 渲染7.1 语法规则inlineRules.js 的emoji: /^(:)([a-z_\d-]?)\1/匹配:emoji名:形式。源码注释如实说明“not real GFM but put it in here”——它并非 GFM 标准而是 MarkText 借鉴 GFM 风格的扩展。7.2 渲染输出inlineLexer.js 在内联解析循环中命中emoji规则后调用renderer.emoji(text, cap[2])renderer.js 优先使用注入的emojiRenderer(emoji)未注入时原样输出文本。在导出链路中exportHtml.js 通过validEmoji校验ui/emojis 提供词表把合法的:emoji:名替换为真实 Unicode emoji 字符非法名则保留:name:原文。TextRenderer的emoji实现textRenderer.js则返回 emoji 名本身用于纯文本抽取。八、Renderer 扩展toc、脚注与上下标除 README 点名的三类 renderer 外该目录还包含若干配套扩展tocrenderer.js 的toc()调用注入的tocRenderer()lexer.js 把[TOC]段落识别为toctoken。导出时 exportHtml.js 将 MarkText 生成的目录 HTML 注入脚注块级footnote规则blockRules.js与行内footnoteIdentifier规则inlineRules.js配套工作。Lexer 会把所有脚注定义统一搬到 token 流末尾并分配唯一 idlexer.jsRenderer 输出符合 ARIA 规范的section classfootnotes与roledoc-noteref引用结构renderer.js上下标superSubScript开启后^x^渲染为sup、~x~渲染为subrenderer.jsTextRenderer同样提供对应实现TextRendererparser.js 额外维护一个使用TextRenderer的inlineText实例用于从标题文本中抽取纯文本再交给 Slugger 生成稳定且去格式化的标题 idunescape(this.inlineText.output(...))。九、真实集成解析器如何服务 MarkText 的两条管线该目录并非孤立代码它是 MarkText 旧内核muyajs的“公共地基”至少被三处直接引用编辑器导入markdown → 块状态importMarkdown.js 以disableInline: true构造Lexer把 markdown 切成块级 token 流再在markdownToState中逐 token 构建编辑器的块树frontmatter→pre/code、hr、blockquote、列表、表格、脚注等最终由parser/render层消费。这里disableInline与列表元信息是保证“所见即所得、光标精确”的关键导出/打印markdown → HTMLexportHtml.js 使用完整marked(markdown, options)注入 Prism 高亮highlight、KaTeXmathRenderer、emoji 词表emojiRenderer与目录tocRenderer产物再经 DOMPurify 配置净化后组装为带页眉页脚的完整 HTML 文档复制粘贴选区 → HTMLcopyCutCtrl.js 在复制富文本时调用marked(selectedText, this.muya.options)生成 HTML 片段实现从 Markdown 选区到剪贴板 HTML 的即时转换。由此可见同一份补丁解析器通过disableInline开关与注入式 renderer在“编辑器实时状态”与“静态导出文档”两条场景间复用这正是 MarkText 选择深度定制而非另起炉灶的工程原因。十、协议与使用前提该目录以 MIT 协议发布README 亦在结尾标注 License 段。使用时需注意两点前提它定位为MarkText 内部依赖其扩展语法frontmatter 四种包裹符、$$公式、:emoji:、上下标、脚注与默认行为emoji/math/frontMatter默认开启均围绕 MarkText 的文档模型定制若要在其他项目直接复用应结合 options.js 按需关闭扩展、或按 exportHtml.js 的模式注入自己的渲染回调它刻意不跟随 Marked.js v1.0.0 之后的破坏性变更因此不承诺与新版 Marked.js 的 API 兼容集成时需保持对旧式Lexer/Parser/Renderer构造风格的认知。总结packages/muyajs/lib/parser/marked是一份“小而精”的 Markdown 解析引擎以 Marked.js v0.8.2 为骨架、吸收 v1.2.5 修复叠加 MarkText 特有的 frontmatter/数学/emoji 扩展并在 Lexer 层为编辑器场景定制了disableInline、富列表元信息与光标签名保护。理解这份实现不仅能看清 MarkText 旧内核的文档处理原理也能为自研编辑器“复用第三方解析器但保留编辑器自由度”提供一份可操作的参考范本。【免费下载链接】marktextA simple and elegant markdown editor, available for Linux, macOS and Windows.项目地址: https://gitcode.com/gh_mirrors/ma/marktext创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 MarkText 内核解析：深入剖析 muyajs 中基于 Marked.js 定制改造的 Markdown 解析器
MarkText 内核解析深入剖析 muyajs 中基于 Marked.js 定制改造的 Markdown 解析器【免费下载链接】marktextA simple and elegant markdown editor, available for Linux, macOS and Windows.项目地址: https://gitcode.com/gh_mirrors/ma/marktextMarkText 仓库中的packages/muyajs是其旧版 JavaScript 内核muya 的前身其中lib/parser/marked目录内嵌了一份经过深度定制的 Marked.js 解析器。本文以 packages/muyajs/lib/parser/marked/README.md 为骨架结合目录下的全部源码与调用方实现完整讲解这份定制解析器的版本基线、扩展功能frontmatter、数学公式、emoji、Lexer/Renderer 改造细节以及它在 MarkText 的导入import、导出export和复制粘贴链路中的真实用法。读完本文你将理解 MarkText 如何让一个第三方 Markdown 引擎同时服务于“编辑器内容状态构建”与“HTML 导出渲染”两条完全不同的消费管线。一、版本基线v0.8.2 v1.2.5 补丁的混合体根据 README.md 的说明该目录中的 Marked.js 补丁版本基于两点主体基于v0.8.2的代码结构合入了v1.2.5中的 bug 修复刻意不包含 v1.0.0 以来的任何破坏性变更no breaking changes fromv1.0.0。这意味着它保留了 v0.8.x 时代new Lexer(...).lex(src)→new Parser(...).parse(tokens)的经典三段式 API同时吸收后续版本对已知缺陷的修复。这一点在源码中可以得到印证index.js 的入口函数marked(src, opt)仍是new Parser(opt).parse(new Lexer(opt).lex(src))并保留了silent模式下返回错误 HTML 片段、否则抛异常的行为但同时inlineLexer.js 中已包含 CommonMark 风格的“匹配尖括号链接”与findClosingBracket处理这些属于较新版本引入的修复逻辑。从代码注释看这份解析器长期服务于 MarkText 的旧内核muyajs许多补丁都直接关联 MarkText 的 issue例如 blockRules.js 中针对有序列表)分隔符的补丁对应 marktext issue #831以及任务列表独立成列表的解析对应 issue #870。二、目录结构一份可独立运行的解析器该目录共 13 个文件构成完整的 Markdown → HTML 解析管线文件职责index.js对外入口marked(src, opt)默认导出函数同时导出Renderer、Lexer、Parseroptions.js全部默认配置项标准项 MarkText 扩展项blockRules.js块级语法规则含 frontmatter、multiplemath 等扩展规则inlineRules.js内联级语法规则含 emoji、math、上下标、脚注引用lexer.js块级 LexerMarkdown 文本 → token 流inlineLexer.js内联 Lexertoken 文本 → 内联 HTMLparser.js按 token 类型驱动各 Renderer 方法输出 HTMLrenderer.js默认 HTML Renderer含全部扩展方法textRenderer.js纯文本 Renderer用于抽取标题纯文本生成 slug/目录slugger.js标题 id 生成slugutils.js正则编辑工具、转义、URL 清洗等urlify.js链接文本 URL 化辅助LICENSEMIT 协议此外还有parser/marked的同级模块 parser/rules.jsMarkText 自研的内联规则集通过findClosingBracket复用了 marked/utils.js 的工具函数说明该目录同时也被当成通用工具库使用。三、配置项全景标准选项与 MarkText 扩展选项options.js 是理解这份解析器行为的钥匙全部默认值如下继承自上游 Marked.js 的标准选项选项默认值含义baseUrlnull相对链接解析的基准 URLbreaksfalse是否把单个换行渲染为brGFM 变体规则gfmtrue启用 GFM 语法表格、删除线、扩展自动链接等headerIdstrue是否给标题生成id锚点headerPrefix标题 id 前缀highlightnull代码高亮回调返回非空且不同于原文时按高亮结果输出langPrefixlanguage-代码块语言 class 前缀mangletrue对自动链接的邮箱做字符实体混淆pedanticfalse严格遵循 Gruber 原始松散规范silentfalse解析出错时静默返回错误 HTML 而非抛异常smartListsfalse是否允许“智能列表”不同 bullet 标记合并为同一列表smartypantsfalse智能标点转换---→破折号、...→省略号等xhtmlfalse是否输出 XHTML 风格自闭合标签sanitize/sanitizerfalse/null已废弃的净化选项源码注释明确建议不要使用MarkText 扩展选项README 所述三大特性的开关选项默认值含义disableInlinefalse内联解析禁用模式见第四节emojitrue是否解析:emoji:语法mathtrue是否解析行内$...$与块级$$...$$数学公式frontMattertrue是否解析文件开头的 frontmatter 元数据superSubScriptfalse是否解析上标^x^与下标~x~footnotefalse是否解析脚注[^id]isGitlabCompatibilityEnabledfalse是否兼容 GitLab 风格显示数学math 围栏isHtmlEnabledtrue是否允许 HTML 标签mathRenderer/emojiRenderer/tocRenderernull注入式自定义渲染回调见第六节代码注释透露了一个设计意图源码中标注 “TODO: We set whether to support emoji, math, frontMatter default value to true / After we add user setting, we maybe set math and frontMatter default value to false”即这些扩展开关未来应下沉到用户设置中控制。四、Lexer 定制disableInline 模式与自定义列表解析README 将 Lexer 层面的改动归纳为四类逐一对应源码4.1disableInline面向“编辑器状态构建”的专用模式这是 MarkText 为编辑器场景引入的关键开关。当disableInline: true时inlineLexer.js 的output()直接返回escape(src)即跳过一切内联语法解析仅做 HTML 转义。它的意义在于编辑器导入 markdown 时只需要“块级结构”标题、列表、代码块、表格、引用内联内容要交给 MarkText 自己的 tokenizer 按光标位置精确切分见 parser/index.js 的tokenizerFac。若在构建块结构时就把内联语法吃掉光标定位和增量编辑就会失真。与此同时lexer.js 在disableInline下会把引用定义def也作为普通段落 token 输出避免定义文本被吞掉。4.2 基于旧版 Marked.js 的自定义列表实现lexer.js 的注释明确写着“Complete list lexer part is a custom implementation based on an older marked.js version”。这份自定义实现比上游 v0.8.2 提供了更丰富的 token 信息list_starttoken 携带ordered是否有序、listTypeorder | task | bullet和start有序列表起始数字每个list_item_starttoken 携带checked任务项勾选状态undefined表示非任务项、listItemType与bulletMarkerOrDelimiterREADME 所说的 “more token information like list item bullet type”使用loose_item_start/list_item_start区分宽松列表项间有空白行与紧凑列表供编辑器还原loose属性。解析时还实现了 CommonMark 264/265 规则bullet 标记变化-→*、有序列表分隔符变化.→)、有序/无序切换、任务项与普通项切换都会分裂成新列表lexer.js并且任务列表被刻意处理为独立列表类型对应 MarkText issue #870。4.3 更多 token 元信息与前后端一致除列表外Lexer 还丰富了其他 tokenheading带headingStyle: atx | setext、code带codeBlockStyle: indented | fenced与lang、hr带原始marker、frontmatter token 带lang与style。这些元信息让 Renderer 与编辑器都能区分语法来源。4.4 光标签名保护cursor signaturelexer.js 从 config/index.js 引入两个随机长 IDCURSOR_ANCHOR_DNA、CURSOR_FOCUS_DNA当编辑器在文档中插入光标占位符anchor/focus时若该占位符位于行首会破坏块级解析。Lexer 在checkCursorSignature开启时会把占位符先剥离、标记再在输出 token 文本时原样回填如cursorAnchorFocus text确保含光标占位符的文档仍能被正确解析。五、Features 详解一frontmatterYAML/TOML/JSON5.1 语法规则blockRules.js 定义了frontmatter正则支持四种包裹符分隔符格式langstyle--- ... ---YAMLyaml- ... TOMLtoml;;; ... ;;;JSON分号风格json;{ ... }JSON花括号风格json{对应地lexer.js 在frontMatter开启且位于文件最开头top且checkFrontmatter时匹配产出{ type: frontmatter, text, style, lang }token。注意checkFrontmatter在第一次匹配尝试后即置为false确保 frontmatter 只在文档头部被识别。5.2 渲染输出renderer.js 的frontmatter()输出pre classfront-matter {text} /pre即渲染为带front-matterclass 的pre块方便主题样式化。5.3 编辑器侧消费在 importMarkdown.js 中frontmattertoken 被还原为pre→code→span三层块结构lang与style原样保存前端再据此按 YAML/TOML/JSON 分派高亮与编辑行为。六、Features 详解二数学公式inline math 与块级 multiplemath6.1 语法规则行内公式inlineRules.js 的math: /^\$([^$]*?[^\$\\])\$(?!\$)/即$...$单美元包裹且刻意排除$$以免与块级冲突块级公式blockRules.js 的multiplemath: /^\$\$\n([\s\S]?)\n\$\$(?:\n|$)/即$$独占一行的包裹GitLab 兼容模式isGitlabCompatibilityEnabled开启后lexer.js 额外匹配 math 围栏multiplemathGitlab规则产出mathStyle: gitlab的multiplemathtoken。6.2 渲染输出与 katex 注入renderer.js 的multiplemath()与inlineMath()遵循“优先回调、失败回退”策略若配置了mathRenderer则调用mathRenderer(text, displayMode)块级displayMode true行内为false无回调或返回空串时块级公式回退为pre classmultiple-math行内公式直接回退为原始文本。在真实导出链路 exportHtml.js 中mathRenderer被实现为KaTeX 的renderToString(math, { displayMode })当公式非法时输出带invalidclass 的占位节点并记录mathRendererCalled标志用于决定是否向最终 HTML 注入katex.css见 exportHtml.js。这也解释了“非破坏性修补”的设计默认配置下 math 渲染为空MarkText 通过选项注入真正的公式引擎而不改动解析器本体。七、Features 详解三emoji 渲染7.1 语法规则inlineRules.js 的emoji: /^(:)([a-z_\d-]?)\1/匹配:emoji名:形式。源码注释如实说明“not real GFM but put it in here”——它并非 GFM 标准而是 MarkText 借鉴 GFM 风格的扩展。7.2 渲染输出inlineLexer.js 在内联解析循环中命中emoji规则后调用renderer.emoji(text, cap[2])renderer.js 优先使用注入的emojiRenderer(emoji)未注入时原样输出文本。在导出链路中exportHtml.js 通过validEmoji校验ui/emojis 提供词表把合法的:emoji:名替换为真实 Unicode emoji 字符非法名则保留:name:原文。TextRenderer的emoji实现textRenderer.js则返回 emoji 名本身用于纯文本抽取。八、Renderer 扩展toc、脚注与上下标除 README 点名的三类 renderer 外该目录还包含若干配套扩展tocrenderer.js 的toc()调用注入的tocRenderer()lexer.js 把[TOC]段落识别为toctoken。导出时 exportHtml.js 将 MarkText 生成的目录 HTML 注入脚注块级footnote规则blockRules.js与行内footnoteIdentifier规则inlineRules.js配套工作。Lexer 会把所有脚注定义统一搬到 token 流末尾并分配唯一 idlexer.jsRenderer 输出符合 ARIA 规范的section classfootnotes与roledoc-noteref引用结构renderer.js上下标superSubScript开启后^x^渲染为sup、~x~渲染为subrenderer.jsTextRenderer同样提供对应实现TextRendererparser.js 额外维护一个使用TextRenderer的inlineText实例用于从标题文本中抽取纯文本再交给 Slugger 生成稳定且去格式化的标题 idunescape(this.inlineText.output(...))。九、真实集成解析器如何服务 MarkText 的两条管线该目录并非孤立代码它是 MarkText 旧内核muyajs的“公共地基”至少被三处直接引用编辑器导入markdown → 块状态importMarkdown.js 以disableInline: true构造Lexer把 markdown 切成块级 token 流再在markdownToState中逐 token 构建编辑器的块树frontmatter→pre/code、hr、blockquote、列表、表格、脚注等最终由parser/render层消费。这里disableInline与列表元信息是保证“所见即所得、光标精确”的关键导出/打印markdown → HTMLexportHtml.js 使用完整marked(markdown, options)注入 Prism 高亮highlight、KaTeXmathRenderer、emoji 词表emojiRenderer与目录tocRenderer产物再经 DOMPurify 配置净化后组装为带页眉页脚的完整 HTML 文档复制粘贴选区 → HTMLcopyCutCtrl.js 在复制富文本时调用marked(selectedText, this.muya.options)生成 HTML 片段实现从 Markdown 选区到剪贴板 HTML 的即时转换。由此可见同一份补丁解析器通过disableInline开关与注入式 renderer在“编辑器实时状态”与“静态导出文档”两条场景间复用这正是 MarkText 选择深度定制而非另起炉灶的工程原因。十、协议与使用前提该目录以 MIT 协议发布README 亦在结尾标注 License 段。使用时需注意两点前提它定位为MarkText 内部依赖其扩展语法frontmatter 四种包裹符、$$公式、:emoji:、上下标、脚注与默认行为emoji/math/frontMatter默认开启均围绕 MarkText 的文档模型定制若要在其他项目直接复用应结合 options.js 按需关闭扩展、或按 exportHtml.js 的模式注入自己的渲染回调它刻意不跟随 Marked.js v1.0.0 之后的破坏性变更因此不承诺与新版 Marked.js 的 API 兼容集成时需保持对旧式Lexer/Parser/Renderer构造风格的认知。总结packages/muyajs/lib/parser/marked是一份“小而精”的 Markdown 解析引擎以 Marked.js v0.8.2 为骨架、吸收 v1.2.5 修复叠加 MarkText 特有的 frontmatter/数学/emoji 扩展并在 Lexer 层为编辑器场景定制了disableInline、富列表元信息与光标签名保护。理解这份实现不仅能看清 MarkText 旧内核的文档处理原理也能为自研编辑器“复用第三方解析器但保留编辑器自由度”提供一份可操作的参考范本。【免费下载链接】marktextA simple and elegant markdown editor, available for Linux, macOS and Windows.项目地址: https://gitcode.com/gh_mirrors/ma/marktext创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考