后端【免费下载链接】parsedownBetter Markdown Parser in PHP项目地址https://gitcode.com/gh_mirrors/pa/parsedown点击查看免费下载导读本文以 Parsedown 仓库中的测试用例 test/data/simple_blockquote.md 为骨架系统讲解 Markdown 引用块blockquote的解析规则——包括缩进、后空格、连续引用与嵌套引用等边界场景并结合 Parsedown.php 中blockQuote、blockQuoteContinue等源码实现与测试框架给出可直接运行验证的实操方案。一、引用块在 Parsedown 中的定位Parsedown 是一款用 PHP 实现的 Markdown 解析器仓库 composer.json 中将其描述为 Parser for Markdown核心实现集中在单文件 Parsedown.php约 2000 行。引用块blockquote是它的块级元素Block Elements之一。在 Parsedown 的解析模型中每一行文本先被拆分为Line包含body、indent、text三个字段见 Parsedown.php随后根据行首字符查表决定采用哪个块级解析器。这个查表逻辑定义在$BlockTypes属性中Parsedown.php其中 array(Quote),即当一行文本以开头时Parsedown 会调用blockQuote()尝试将其识别为引用块。这一标记字符 → 解析器的映射机制是理解引用块行为的第一块基石。二、从测试用例出发simple_blockquote.md 逐行解析2.1 测试数据与预期输出本主题的核心文档 test/data/simple_blockquote.md 内容如下 quote indented: quote no space after : quote --- Info 1 text Info 2 text其对应的预期 HTML 输出记录在 test/data/simple_blockquote.htmlblockquote pquote/p /blockquote pindented:/p blockquote pquote/p /blockquote pno space after codegt;/code:/p blockquote pquote/p /blockquote hr / blockquote blockquote blockquote pInfo 1 text/p /blockquote /blockquote /blockquote blockquote blockquote blockquote pInfo 2 text/p /blockquote /blockquote /blockquote这份用例虽然只有 13 行 Markdown却覆盖了引用块的全部核心语法分支基础引用、带缩进的引用、后无空格的引用、水平分隔线与引用块的交互、以及连续的多层嵌套引用。下面逐段展开。2.2 基础引用 quote最普通的引用写法是行首后跟一个空格再加正文 quoteParsedown 输出blockquote pquote/p /blockquote从源码看这一识别动作由 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; } }注意正则^[ ]?(.*)之后允许 0 个或 1 个空格[ ]?为占有量词剩余部分整体作为引用内容。这里引用的正文quote被交给linesElements()递归处理——引用块内部的文本会再次走完整的块级解析流程这正是引用块内还能嵌套标题、列表、分隔线的根本原因详见第五节。2.3 缩进后的引用 quote测试文档第二段演示了行首带空格的引用indented: quote其中indented:是一个普通段落而 quote是行首有 3 个空格、随后才是的引用。Parsedown 将其解析为与基础引用完全相同的 HTMLpindented:/p blockquote pquote/p /blockquote关键点在于Parsedown 处理每一行时会先计算缩进strspn($line, )见 Parsedown.php并把去缩进后的内容放进$Line[text]块级解析器包括blockQuote实际匹配的是去除行首缩进之后的文本。因此 13 个空格的前导缩进不会破坏引用识别。需要留意的是若缩进达到 4 个空格行为就会不同4 空格缩进在 Markdown 中会被识别为代码块blockCode检查$Line[indent] 4见 Parsedown.php这属于代码块而非引用块的范畴。2.4后没有空格quote测试文档特意用反引号包裹了以展示原文字面量然后给出实际输入no space after : quote注意no space after \:中的 会被解析成行内代码在 HTML 中被转义为而下一行的quote 同样被识别为引用pno space after codegt;/code:/p blockquote pquote/p /blockquote这正对应源码正则^[ ]?(.*)中[ ]?的0 或 1 个空格语义——后即使紧贴正文无空格也能命中正则quote被捕获为引用内容。这是 Parsedown 较宽松的一处实现CommonMark 规范要求后必须跟空格或行尾而 Parsedown 允许无空格也是与必须加空格的常见习惯不同的一点值得在实际使用中留意。2.5 分隔线与引用的分隔---测试文档在两组引用之间放置了一个---quote --- Info 1 text---在 Parsedown 中被解析为水平分隔线hr /同时作为块边界把上方和下方的引用块分隔开。预期输出中---前是/blockquote---后重新开始新的blockquote二者互不干扰。---的识别由 blockRule() 完成它要求同一标记字符-、*或_在行内出现至少 3 次且去除空格与标记后行为空protected function blockRule($Line) { $marker $Line[text][0]; if (substr_count($Line[text], $marker) 3 and chop($Line[text], $marker) ) { // 生成 name 为 hr 的块元素 } }从$BlockTypes的映射可以看到-开头的行会依次尝试SetextHeader、Table、Rule、List四种解析器Parsedown.phpblockRule是其中负责水平分隔线的一个。引用块遇到不匹配的---行时blockQuoteContinue()返回空当前引用块随即被收尾---开启新的块。2.6 连续多行多重嵌套引用测试文档的最后一部分是两组三连的输入 Info 1 text Info 2 text每组都输出三层嵌套的blockquoteblockquote blockquote blockquote pInfo 1 text/p /blockquote /blockquote /blockquote这是因为blockQuote()每次匹配^[ ]?(.*)时只剥离最外层的一个剩余的 Info 1 text作为参数交给linesElements()递归解析递归过程中linesElements()又会为下一行重新执行块识别$BlockTypes中仍映射到Quote从而再次触发blockQuote()。如此反复每一层生成一层blockquote最终在最内层解析出段落文本。三连就对应三层嵌套而两组输入之间隔着空行故生成两个互相独立的嵌套引用块。三、引用块内部的内容由linesElements()递归处理从上一节可以看出理解引用块的关键在于它的 handlerhandler array( function linesElements, argument (array) $matches[1], destination elements, ),引用块剥掉一层后的正文被重新送入 linesElements() 这条完整的块级解析流水线。这意味着引用块内部可以使用全部块级语法段落、标题、列表、分隔线、代码块、甚至更深层的引用。仓库中的配套用例印证了这一点例如 test/data/compound_blockquote.md header ------ paragraph - li --- paragraph输出见 test/data/compound_blockquote.htmlblockquote h2header/h2 pparagraph/p ul lili/li /ul hr / pparagraph/p /blockquote其中 header下的 ------触发了 Setext 二级标题h2 - li生成无序列表 ---生成分隔线——全部发生在同一个引用块内部。这正是引用块是块级语法的容器这一设计的直接体现。四、多行引用与 lazy continuationblockQuoteContinue()引用块并不止于单行。Parsedown 用 blockQuoteContinue() 处理引用块的延续protected function blockQuoteContinue($Line, array $Block) { if (isset($Block[interrupted])) { return; } if ($Line[text][0] and preg_match(/^[ ]?(.*)/, $Line[text], $matches)) { $Block[element][handler][argument] [] $matches[1]; return $Block; } if ( ! isset($Block[interrupted])) { $Block[element][handler][argument] [] $Line[text]; return $Block; } }两个分支对应两种延续方式带标记的延续行后续行仍以开头时继续剥离标记并把内容追加进引用块lazy continuation惰性延续后续行没有标记但只要引用块尚未被空行打断interrupted该行仍被并入当前引用块。interrupted标记在 linesElements() 中维护每当遇到空行当前块都会被标记为interrupted连续空行则计数递增。blockQuoteContinue()在interrupted已存在时直接返回空从而终止引用块。仓库用 test/data/lazy_blockquote.md 专门验证惰性延续行为 quote the rest of it another paragraph the rest of it其预期输出test/data/lazy_blockquote.html为两个独立的引用块每个内部都是跨两行的段落blockquote pquote the rest of it/p /blockquote blockquote panother paragraph the rest of it/p /blockquote也就是说引用标记行与无标记行之间没有空行时无标记行会被吸入引用块一旦出现空行interrupted引用块结束后续内容回归普通段落。测试文档 simple_blockquote.md 中 quote与indented:之间的空行也正是通过这一机制让引用块在indented:段落之前正确收尾。关于块的续接与收尾Parsedown 有两个通用的探测方法isBlockContinuable() 检查是否存在blockXxxContinue方法isBlockCompletable() 检查是否存在blockXxxComplete方法。Quote只定义了 Continue 方法、没有 Complete 方法所以引用块在遇到不匹配行或文件结尾时直接由extractElement()收尾出块无需额外的补全逻辑。五、把整个链路串起来一次解析的完整调用流综合源码可以勾勒出 quote从输入到 HTML 的完整调用链用户调用公开入口 text()内部先执行textElements()Parsedown.php统一换行符\r\n、\r归一为\n、去除首尾空行、按\n拆成行数组linesElements()逐行迭代Parsedown.php处理 tab 展开、计算缩进、构造$Line再用行首字符$marker $text[0]查$BlockTypes表命中对应的Quote调用blockQuote()生成引用块骨架并将剥壳后的正文交回linesElements()递归解析后续行调用blockQuoteContinue()决定续行带或惰性延续遇空行则interrupted引用块终止块内递归产出的$Elements最终由elements()渲染成嵌套的blockquote.../blockquoteHTMLtext()再修剪首尾换行后返回。这条链路中引用块的递归解析特性贯穿始终块级语法段落、标题、列表、分隔线、嵌套引用在linesElements()内统一处理引用块只是把内容换个作用域重新走一遍流程。这也是为什么 Info 1 text能干净利落地生成三层嵌套。六、实操用仓库自带测试直接验证引用块行为本主题无需安装任何依赖即可用仓库自带测试框架验证。项目在 phpunit.xml.dist 中声明了Parsedown测试套件入口是 test/ParsedownTest.php。ParsedownTest::data()test/ParsedownTest.php会扫描test/data/目录下所有.md文件并为每个存在同名.html文件的用例生成数据组test_()test/ParsedownTest.php则读取.md输入、读取.html期望输出调用$this-Parsedown-text($markdown)后断言两者相等。也就是说simple_blockquote 这个用例天然就是输入 → 输出的自动化回归测试。在仓库根目录执行# 安装开发依赖PHPUnitPHP 7.2需要 mbstring 扩展 composer install # 运行全部测试 vendor/bin/phpunit # 仅运行引用块相关用例按测试名过滤 vendor/bin/phpunit --filter simple_blockquote vendor/bin/phpunit --filter lazy_blockquote vendor/bin/phpunit --filter compound_blockquote若没有 composer也可以直接用 PHP 命令行做一次最小验证php -r require Parsedown.php; echo (new Parsedown)-text( quote);预期输出blockquote pquote/p /blockquote仓库中与引用块直接相关的测试数据文件还包括test/data/simple_blockquote.md 与 test/data/simple_blockquote.html基础、缩进、无空格、分隔线、嵌套引用test/data/lazy_blockquote.md 与 test/data/lazy_blockquote.html惰性延续与空行终止test/data/compound_blockquote.md 与 test/data/compound_blockquote.html引用块内嵌套标题、列表、分隔线。七、边界与注意事项基于上述源码与测试数据使用 Parsedown 的引用块时有几点值得注意后空格可选正则^[ ]?(.*)允许后无空格如quote比 CommonMark 的严格规则更宽松。若你希望强制要求空格需要在解析前自行预处理。前导缩进 13 个空格仍可识别去缩进后的文本以开头即可但 4 个空格及以上会优先落入代码块blockCode的$Line[indent] 4判断不再作为引用。空行是引用块的终止符linesElements()遇到空行会给当前块打上interrupted标记blockQuoteContinue()随即停止并入。惰性延续只在无空行中断时生效。嵌套深度与数量一一对应每多一个就多一层blockquote多层嵌套由递归的linesElements()自然产出。引用块是块级容器内部可包含标题、列表、分隔线、段落乃至更深层的引用但行内语法如强调、链接由块内文本进入lineElements()行内解析时再处理两者职责分离。环境要求使用 Parsedown 需要 PHP 7.2 及 mbstring 扩展见 composer.json当前源码版本为 1.8.0Parsedown.php。总结引用块在 Parsedown 中由blockQuote/blockQuoteContinue两个方法驱动核心机制是每次只剥一层把剩余内容递归交给linesElements()重新解析。配合 test/data/simple_blockquote.md 这份覆盖 6 种语法分支的测试用例你既能在源码层面理解每一层blockquote的来龙去脉也能用仓库自带的 PHPUnit 用例快速验证任意引用块输入的解析结果。赞分享后端【免费下载链接】parsedownBetter Markdown Parser in PHP项目地址https://gitcode.com/gh_mirrors/pa/parsedown点击查看免费下载相关推荐Cherry Markdown引用块Blockquote样式与嵌套Cherry Markdown引用块Blockquote样式与嵌套 引用是思想的传承嵌套是逻辑的延伸。 —— 在Markdown写作中引用块Bloc前端UI组件富文本Parsedown 复合列表解析原理列表项中段落与引用块嵌套的块级语义详解Parsedown 复合列表解析原理列表项中段落与引用块嵌套的块级语义详解 导读 本文围绕 Parsedown 官方测试用例 test/data/compou后端Parsedown 复合引用块Compound Blockquote解析原理与实战一个 内如何渲染出标题、列表与分割线Parsedown 复合引用块Compound Blockquote解析原理与实战一个 内如何渲染出标题、列表与分割线 导读 本文以 Parsedown后端上一篇WebARonARKit与three.js整合实战创建交互式AR购物体验下一篇Filament Input Wrapper 组件详解为表单输入框构建边框、前后缀与状态反馈创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考