如何用Go语言实现Markdown解析器?实战文本处理技巧分享
- 内容介绍
- 文章标签
- 相关推荐
本文共计1065个文字,预计阅读时间需要5分钟。
因为您需要的是简单——不是功能完整,而是可控制、可调试,并能嵌入到小工具中而不带有一堆依赖。目前,库中有几百个文件,使用goldmark的扩展机制绕三圈才适配得好一个自定义节点。而blackfriday已归档且不支持Go modules早期版本的路径解析,容易出错。真的动手写,核心就是两件事:
strings.Split 不能直接切 Markdown 块,得按空行+缩进状态走
Markdown 块级元素(比如段落、列表项、代码块)靠空行分隔,但空行可能被缩进干扰,比如 YAML front matter 后紧接一个缩进的列表,strings.Split 一刀切会把整个 front matter 和后续内容混成一块。正确做法是逐行扫描,维护一个 inList 状态和当前缩进深度:
- 遇到以
-、*或数字加.开头的行,且缩进 ≤ 当前列表层级,就开启新列表项 - 连续空行只算一个分隔符;单个空行在代码块里不算分隔(得看是否在
```内) - 用
strings.TrimSpace判断空行,别用== "",因为可能含 \t 或 \r
行内解析必须用状态机,正则替换会吃掉嵌套强调
比如 *a *b* c* 这种嵌套斜体,用 regexp.ReplaceAllString 两次(先处理 ** 再处理 *)会错乱。
本文共计1065个文字,预计阅读时间需要5分钟。
因为您需要的是简单——不是功能完整,而是可控制、可调试,并能嵌入到小工具中而不带有一堆依赖。目前,库中有几百个文件,使用goldmark的扩展机制绕三圈才适配得好一个自定义节点。而blackfriday已归档且不支持Go modules早期版本的路径解析,容易出错。真的动手写,核心就是两件事:
strings.Split 不能直接切 Markdown 块,得按空行+缩进状态走
Markdown 块级元素(比如段落、列表项、代码块)靠空行分隔,但空行可能被缩进干扰,比如 YAML front matter 后紧接一个缩进的列表,strings.Split 一刀切会把整个 front matter 和后续内容混成一块。正确做法是逐行扫描,维护一个 inList 状态和当前缩进深度:
- 遇到以
-、*或数字加.开头的行,且缩进 ≤ 当前列表层级,就开启新列表项 - 连续空行只算一个分隔符;单个空行在代码块里不算分隔(得看是否在
```内) - 用
strings.TrimSpace判断空行,别用== "",因为可能含 \t 或 \r
行内解析必须用状态机,正则替换会吃掉嵌套强调
比如 *a *b* c* 这种嵌套斜体,用 regexp.ReplaceAllString 两次(先处理 ** 再处理 *)会错乱。

