后端【免费下载链接】parsedownBetter Markdown Parser in PHP项目地址https://gitcode.com/gh_mirrors/pa/parsedown点击查看免费下载导读本文围绕 Parsedown 官方测试用例 test/data/compound_list.md 与其期望输出 test/data/compound_list.html深入剖析一个核心 Markdown 解析问题列表项内部如何承载多个块级元素多个段落、引用块 blockquote。通过对照源码 Parsedown.php 中blockList、blockListContinue、blockQuote与li等关键方法的实现你将掌握 Parsedown 对复合列表compound list的判定规则、松散列表loose list的触发条件以及嵌套块级内容的渲染方式并学会用官方测试套件验证自己的理解。一、测试用例本体6 行 Markdown四种块级结构compound_list.md全文仅有 6 行但它覆盖了复合列表中极具代表性的两种形态- paragraph paragraph - paragraph quote按行分解行内容作用1- paragraph无序列表第 1 项含首个段落2空行打断列表项的段落连续性触发 loose 判定3paragraph第 1 项内第二个段落缩进 2 空格4空行结束第 1 项5- paragraph无序列表第 2 项含段落6 quote第 2 项内缩进 2 空格后嵌套的引用块期望输出compound_list.html明确了渲染语义ul li pparagraph/p pparagraph/p /li li pparagraph/p blockquote pquote/p /blockquote /li /ul关键结论一目了然列表项内部可以包含多个块级元素且每一项都被p包裹说明这是典型的松散列表loose list——因为第 1 行到第 3 行之间出现了空行分隔。二、复合列表为何成立从块级容器的视角理解列表Parsedown 中列表不是简单的一行一li的字符串拼接而是一个可容纳任意块级子结构的容器。这一设计直接体现在 Parsedown.php 中$Block[li] array( name li, handler array( function li, argument !empty($matches[3]) ? array($matches[3]) : array(), destination elements ) ); $Block[element][elements] [] $Block[li];li的 handler 把列表项内的全部内容行交给li()方法递归处理而 li() 又调用linesElements()对内容重新做一次完整的块级解析protected function li($lines) { $Elements $this-linesElements($lines); if ( ! in_array(, $lines) and isset($Elements[0]) and isset($Elements[0][name]) and $Elements[0][name] p ) { unset($Elements[0][name]); } return $Elements; }这正是复合列表的底层根基列表项的正文不是纯文本而是被当作一段独立的 Markdown 输入重新解析。linesElements()见 Parsedown.php是 Parsedown 的块级主循环同一套状态机既驱动顶层文档也驱动每个列表项因此段落、引用块、代码块、子列表等块级元素在列表项内部天然可用。2.1 空行与interrupted标记列表从紧凑变为松散compound_list.md中第 1 项内部出现的空行是理解输出结果中p标签的关键。在linesElements()中空行会将当前块标记为被打断Parsedown.phpif (chop($line) ) { if (isset($CurrentBlock)) { $CurrentBlock[interrupted] (isset($CurrentBlock[interrupted]) ? $CurrentBlock[interrupted] 1 : 1 ); } continue; }在 blockListContinue() 中一旦检测到列表项内存在interrupted且随后仍有内容行续接就会设置$Block[loose] trueif (isset($Block[interrupted])) { $Block[li][handler][argument] [] ; $Block[loose] true; unset($Block[interrupted]); }随后 blockListComplete() 在列表结束时为松散列表的每个li补一个空行参数使其内容按多段落处理protected function blockListComplete(array $Block) { if (isset($Block[loose])) { foreach ($Block[element][elements] as $li) { if (end($li[handler][argument]) ! ) { $li[handler][argument] [] ; } } } return $Block; }而li()中的一行if ( ! in_array(, $lines) ... unset($Elements[0][name])则说明只有当列表项内容不含空行紧凑列表时首个段落才会被去掉p包裹形成常见的紧凑渲染- item。compound_list.md的两项都含空行因此每个段落都保留p标签——这正是期望输出 HTML 中每个li内部段落均有p的原因。2.2 缩进对齐列表项内容如何贴附到所在项compound_list.md中第二个段落和引用块都缩进了 2 个空格。这个缩进量并非随意而是与列表标记-的宽度对应。在 blockList() 中if (preg_match(/^(.$pattern.([ ]|$))(.*)/, $Line[text], $matches)) { $contentIndent strlen($matches[2]); ... }-的 marker 长度为 2因此后续行只要缩进 2即$requiredIndent $Block[indent] strlen($Block[data][marker])见 blockListContinue()就会被判定为该列表项的内容行在 blockListContinue() 中这些行通过substr($Line[body], $requiredIndent)剥离缩进后追加进当前li的参数数组if ($Line[indent] $requiredIndent) { ... $text substr($Line[body], $requiredIndent); $Block[li][handler][argument] [] $text; return $Block; }正是这一缩进即归属的规则让第 6 行的 quote进入第 2 个li的参数序列再交由li()→linesElements()递归识别为引用块。三、嵌套引用块blockQuote在列表项内的二次触发第 6 行 quote被剥离 2 空格缩进后其有效文本为 quote。当li()将这些行送入linesElements()重新做块级解析时blockQuote() 便以顶层等价的身份命中protected function blockQuote($Line) { if (preg_match(/^[ ]?(.*)/, $Line[text], $matches)) { $Block array( element array( name blockquote, handler array( function linesElements, argument (array) $matches[1], destination elements, ) ), ); return $Block; } }blockquote的 handler 同样指向linesElements()于是quote文本继续被解析为段落最终生成blockquotepquote/p/blockquote。整条解析链路可以概括为列表行(- paragraph) → blockList 创建 ul/li 容器 → blockListContinue 依据缩进与空行累积各项内容行 → blockListComplete 将松散列表补齐空行参数 → li() 递归调用 linesElements() → blockParagraph 生成 pparagraph/p → blockQuote 生成 blockquotepquote/p/blockquote从中可以推断列表项内的块级嵌套是通过递归重启块级状态机实现的而非特化的列表分支逻辑。这也是为什么 Parsedown 可以支持列表项内嵌套任意深度的其他块级元素。四、如何在测试套件中复现与验证compound_list.md是 Parsedown 官方测试夹具的一部分。测试入口在 test/ParsedownTest.php其test_方法test/ParsedownTest.php逐对读取data/*.md与data/*.html$markdown file_get_contents($dir . $test . .md); $expectedMarkup file_get_contents($dir . $test . .html); $actualMarkup $this-Parsedown-text($markdown); $this-assertEquals($expectedMarkup, $actualMarkup);运行方式项目已提供 phpunit.xml.dist 与 composer.jsoncomposer install # 安装 PHPUnit 依赖 vendor/bin/phpunit # 运行全部 Parsedown 测试 vendor/bin/phpunit --filter test_compound_list # 仅运行 compound_list 用例若修改了compound_list.md内容需同步更新compound_list.html否则测试将因期望输出不匹配而失败——这正是用输入/输出夹具对锁死解析语义的典型做法。五、与相邻测试用例的对照复合列表的边界行为test/data/目录下还有一组与复合列表语义紧密相关的夹具可作为延伸阅读test/data/paragraph_list.md列表前后的独立段落与空行分隔关系对应输出paragraph_list.htmltest/data/multiline_list_paragraph.md列表项内多行连续文本如何归入同一段落紧凑列表的p剥离行为在此可见端倪test/data/multiline_lists.md 与 test/data/compound_blockquote.md更复杂的多块级组合场景test/data/compound_emphasis.md块级结构内部的跨行行内强调解析。将这些用例与compound_list.md对照阅读可以完整勾勒出 Parsedown 对块级容器嵌套的统一处理模型无论是列表、引用块还是代码块其内部内容一律通过 handler 递归复用linesElements()状态机从而在保证解析器核心精简的同时获得极强的嵌套表达能力。结语compound_list.md虽然只有 6 行却是理解 Parsedown 块级解析架构的最佳切入口。它的期望输出揭示了三个关键事实其一列表是块级容器而非文本拼接其二空行会驱动loose标记决定段落是否包裹p其三列表项内容通过li()→linesElements()递归重解析使得段落、引用块等块级元素可以任意嵌套。掌握这一模型后你在使用或二次开发 Parsedown 时便能准确预判复合列表、嵌套引用等场景的输出结果也能更高效地定位 Parsedown.php 中的相关实现。赞分享后端【免费下载链接】parsedownBetter Markdown Parser in PHP项目地址https://gitcode.com/gh_mirrors/pa/parsedown点击查看免费下载相关推荐CKEditor 5 列表编辑行为详解块级列表项、缩进嵌套、跳级列表与相邻列表合并CKEditor 5 列表编辑行为详解块级列表项、缩进嵌套、跳级列表与相邻列表合并 本文基于 CKEditor 5 官方功能文档 Lists editing前端富文本UI组件Parsedown 复合引用块Compound Blockquote解析原理与实战一个 内如何渲染出标题、列表与分割线Parsedown 复合引用块Compound Blockquote解析原理与实战一个 内如何渲染出标题、列表与分割线 导读 本文以 Parsedown后端marked 中 Tab 字符的解析全解缩进代码块、列表嵌套与制表位展开原理marked 中 Tab 字符的解析全解缩进代码块、列表嵌套与制表位展开原理 导读 本文以 marked 仓库内置测试规格 test/specs/origi前端上一篇Headroom Prometheus指标大全tokens_saved、overhead_ms、stage_timing逐条解读下一篇Chalice 自定义域名配置完全指南为 REST 与 WebSocket API 绑定专属域名创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/3 1:55:27 · 阅读 1.2k Parsedown 复合列表解析原理：列表项中段落与引用块嵌套的块级语义详解
后端【免费下载链接】parsedownBetter Markdown Parser in PHP项目地址https://gitcode.com/gh_mirrors/pa/parsedown点击查看免费下载导读本文围绕 Parsedown 官方测试用例 test/data/compound_list.md 与其期望输出 test/data/compound_list.html深入剖析一个核心 Markdown 解析问题列表项内部如何承载多个块级元素多个段落、引用块 blockquote。通过对照源码 Parsedown.php 中blockList、blockListContinue、blockQuote与li等关键方法的实现你将掌握 Parsedown 对复合列表compound list的判定规则、松散列表loose list的触发条件以及嵌套块级内容的渲染方式并学会用官方测试套件验证自己的理解。一、测试用例本体6 行 Markdown四种块级结构compound_list.md全文仅有 6 行但它覆盖了复合列表中极具代表性的两种形态- paragraph paragraph - paragraph quote按行分解行内容作用1- paragraph无序列表第 1 项含首个段落2空行打断列表项的段落连续性触发 loose 判定3paragraph第 1 项内第二个段落缩进 2 空格4空行结束第 1 项5- paragraph无序列表第 2 项含段落6 quote第 2 项内缩进 2 空格后嵌套的引用块期望输出compound_list.html明确了渲染语义ul li pparagraph/p pparagraph/p /li li pparagraph/p blockquote pquote/p /blockquote /li /ul关键结论一目了然列表项内部可以包含多个块级元素且每一项都被p包裹说明这是典型的松散列表loose list——因为第 1 行到第 3 行之间出现了空行分隔。二、复合列表为何成立从块级容器的视角理解列表Parsedown 中列表不是简单的一行一li的字符串拼接而是一个可容纳任意块级子结构的容器。这一设计直接体现在 Parsedown.php 中$Block[li] array( name li, handler array( function li, argument !empty($matches[3]) ? array($matches[3]) : array(), destination elements ) ); $Block[element][elements] [] $Block[li];li的 handler 把列表项内的全部内容行交给li()方法递归处理而 li() 又调用linesElements()对内容重新做一次完整的块级解析protected function li($lines) { $Elements $this-linesElements($lines); if ( ! in_array(, $lines) and isset($Elements[0]) and isset($Elements[0][name]) and $Elements[0][name] p ) { unset($Elements[0][name]); } return $Elements; }这正是复合列表的底层根基列表项的正文不是纯文本而是被当作一段独立的 Markdown 输入重新解析。linesElements()见 Parsedown.php是 Parsedown 的块级主循环同一套状态机既驱动顶层文档也驱动每个列表项因此段落、引用块、代码块、子列表等块级元素在列表项内部天然可用。2.1 空行与interrupted标记列表从紧凑变为松散compound_list.md中第 1 项内部出现的空行是理解输出结果中p标签的关键。在linesElements()中空行会将当前块标记为被打断Parsedown.phpif (chop($line) ) { if (isset($CurrentBlock)) { $CurrentBlock[interrupted] (isset($CurrentBlock[interrupted]) ? $CurrentBlock[interrupted] 1 : 1 ); } continue; }在 blockListContinue() 中一旦检测到列表项内存在interrupted且随后仍有内容行续接就会设置$Block[loose] trueif (isset($Block[interrupted])) { $Block[li][handler][argument] [] ; $Block[loose] true; unset($Block[interrupted]); }随后 blockListComplete() 在列表结束时为松散列表的每个li补一个空行参数使其内容按多段落处理protected function blockListComplete(array $Block) { if (isset($Block[loose])) { foreach ($Block[element][elements] as $li) { if (end($li[handler][argument]) ! ) { $li[handler][argument] [] ; } } } return $Block; }而li()中的一行if ( ! in_array(, $lines) ... unset($Elements[0][name])则说明只有当列表项内容不含空行紧凑列表时首个段落才会被去掉p包裹形成常见的紧凑渲染- item。compound_list.md的两项都含空行因此每个段落都保留p标签——这正是期望输出 HTML 中每个li内部段落均有p的原因。2.2 缩进对齐列表项内容如何贴附到所在项compound_list.md中第二个段落和引用块都缩进了 2 个空格。这个缩进量并非随意而是与列表标记-的宽度对应。在 blockList() 中if (preg_match(/^(.$pattern.([ ]|$))(.*)/, $Line[text], $matches)) { $contentIndent strlen($matches[2]); ... }-的 marker 长度为 2因此后续行只要缩进 2即$requiredIndent $Block[indent] strlen($Block[data][marker])见 blockListContinue()就会被判定为该列表项的内容行在 blockListContinue() 中这些行通过substr($Line[body], $requiredIndent)剥离缩进后追加进当前li的参数数组if ($Line[indent] $requiredIndent) { ... $text substr($Line[body], $requiredIndent); $Block[li][handler][argument] [] $text; return $Block; }正是这一缩进即归属的规则让第 6 行的 quote进入第 2 个li的参数序列再交由li()→linesElements()递归识别为引用块。三、嵌套引用块blockQuote在列表项内的二次触发第 6 行 quote被剥离 2 空格缩进后其有效文本为 quote。当li()将这些行送入linesElements()重新做块级解析时blockQuote() 便以顶层等价的身份命中protected function blockQuote($Line) { if (preg_match(/^[ ]?(.*)/, $Line[text], $matches)) { $Block array( element array( name blockquote, handler array( function linesElements, argument (array) $matches[1], destination elements, ) ), ); return $Block; } }blockquote的 handler 同样指向linesElements()于是quote文本继续被解析为段落最终生成blockquotepquote/p/blockquote。整条解析链路可以概括为列表行(- paragraph) → blockList 创建 ul/li 容器 → blockListContinue 依据缩进与空行累积各项内容行 → blockListComplete 将松散列表补齐空行参数 → li() 递归调用 linesElements() → blockParagraph 生成 pparagraph/p → blockQuote 生成 blockquotepquote/p/blockquote从中可以推断列表项内的块级嵌套是通过递归重启块级状态机实现的而非特化的列表分支逻辑。这也是为什么 Parsedown 可以支持列表项内嵌套任意深度的其他块级元素。四、如何在测试套件中复现与验证compound_list.md是 Parsedown 官方测试夹具的一部分。测试入口在 test/ParsedownTest.php其test_方法test/ParsedownTest.php逐对读取data/*.md与data/*.html$markdown file_get_contents($dir . $test . .md); $expectedMarkup file_get_contents($dir . $test . .html); $actualMarkup $this-Parsedown-text($markdown); $this-assertEquals($expectedMarkup, $actualMarkup);运行方式项目已提供 phpunit.xml.dist 与 composer.jsoncomposer install # 安装 PHPUnit 依赖 vendor/bin/phpunit # 运行全部 Parsedown 测试 vendor/bin/phpunit --filter test_compound_list # 仅运行 compound_list 用例若修改了compound_list.md内容需同步更新compound_list.html否则测试将因期望输出不匹配而失败——这正是用输入/输出夹具对锁死解析语义的典型做法。五、与相邻测试用例的对照复合列表的边界行为test/data/目录下还有一组与复合列表语义紧密相关的夹具可作为延伸阅读test/data/paragraph_list.md列表前后的独立段落与空行分隔关系对应输出paragraph_list.htmltest/data/multiline_list_paragraph.md列表项内多行连续文本如何归入同一段落紧凑列表的p剥离行为在此可见端倪test/data/multiline_lists.md 与 test/data/compound_blockquote.md更复杂的多块级组合场景test/data/compound_emphasis.md块级结构内部的跨行行内强调解析。将这些用例与compound_list.md对照阅读可以完整勾勒出 Parsedown 对块级容器嵌套的统一处理模型无论是列表、引用块还是代码块其内部内容一律通过 handler 递归复用linesElements()状态机从而在保证解析器核心精简的同时获得极强的嵌套表达能力。结语compound_list.md虽然只有 6 行却是理解 Parsedown 块级解析架构的最佳切入口。它的期望输出揭示了三个关键事实其一列表是块级容器而非文本拼接其二空行会驱动loose标记决定段落是否包裹p其三列表项内容通过li()→linesElements()递归重解析使得段落、引用块等块级元素可以任意嵌套。掌握这一模型后你在使用或二次开发 Parsedown 时便能准确预判复合列表、嵌套引用等场景的输出结果也能更高效地定位 Parsedown.php 中的相关实现。赞分享后端【免费下载链接】parsedownBetter Markdown Parser in PHP项目地址https://gitcode.com/gh_mirrors/pa/parsedown点击查看免费下载相关推荐CKEditor 5 列表编辑行为详解块级列表项、缩进嵌套、跳级列表与相邻列表合并CKEditor 5 列表编辑行为详解块级列表项、缩进嵌套、跳级列表与相邻列表合并 本文基于 CKEditor 5 官方功能文档 Lists editing前端富文本UI组件Parsedown 复合引用块Compound Blockquote解析原理与实战一个 内如何渲染出标题、列表与分割线Parsedown 复合引用块Compound Blockquote解析原理与实战一个 内如何渲染出标题、列表与分割线 导读 本文以 Parsedown后端marked 中 Tab 字符的解析全解缩进代码块、列表嵌套与制表位展开原理marked 中 Tab 字符的解析全解缩进代码块、列表嵌套与制表位展开原理 导读 本文以 marked 仓库内置测试规格 test/specs/origi前端上一篇Headroom Prometheus指标大全tokens_saved、overhead_ms、stage_timing逐条解读下一篇Chalice 自定义域名配置完全指南为 REST 与 WebSocket API 绑定专属域名创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考