普贤教程 › 包参考

richmd 包

Markdown 富文本（ANSI）渲染

项	值
包名	`richmd`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`richmd.px`
分类	`数据格式与编解码`
文件数 / 行数	`1 / 432`

安装与引入

bash

pxpkg init          # 首次
pxpkg add richmd@0.2.0
pxpkg install

import richmd

所属分类教程：数据格式与编解码

公开接口

函数	参数
`mdr_render`	`src`
`mdr_strip`	`s`

其余 17 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`o_sgr`	`codes`
`o_reset`
`o_bold`	`s`
`o_ital`	`s`
`o_under`	`s`
`o_strike`	`s`
`o_fg`	`s, code`
`o_bg`	`s, code`
`o_find`	`s, sub, start`
`o_next_marker`	`s, start`
`mdr_inline`	`s`
`mdr_render_plain`	`src`
`mdr_strip_md`	`src`
`mdr_strip_md_inline`	`s`
`mdr_inline_html`	`s`
`mdr_render_html`	`src`
`mdr_count_words`	`src`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/richmd —— Markdown 富文本（ANSI）渲染
------------------------------------------------------------
纯函数库（无 IO、无状态），编译（px build）与解释（px run）双模式一致。
mdr_render(src) → Ok(str)   # Markdown → ANSI 富文本串（标题/列表/引用/代码块/行内样式/链接）
mdr_strip(s)    → Ok(str)   # 剥掉 ANSI 转义 → 纯文本
支持的块：ATX 标题(#~######) · 无序/有序列表 · 引用(>) · 分隔线(---)
围栏代码块(```/~~~) · 段落
行内：**粗体** *斜体* `行内代码` ~~删除线~~ [文本](链接)
说明：
- 单文件自包含（pxpkg 单 .px 分发），不依赖 sibling 库。
- 输出 xterm-256 常用色号；mdr_strip 可还原纯文本（清屏/落档用）。
- 未闭合行内标记按原文透传（不 panic）。
============================================================