remark：转换 Markdown 的神器

type

Post

status

Published

date

Mar 14, 2025

slug

remark-transforms-markdown-to-html

summary

remark 是一个使用插件转换 Markdown 的工具。它可以检查和修改您的标记，可以在服务器、客户端、CLI、Deno 等上使用 remark。另外，remark 还是一个插件生态系统，它使用 markdown 作为结构化数据，特别是 AST（抽象语法树）。AST 使程序可以轻松处理 markdown，我们称这些程序为插件。remark 生态系统包含许多现有插件，当然也可以自己制作插件。

1、remark主要功能点

100% 符合 CommonMark 和 GFM 或 MDX(通过插件)

AST抽象语法树(AST)使检查和修改内容变得更加容易

popular世界上最流行的 Markdown 解析器

插件150 多个可选择的插件

2、remark如何使用

将markdown 转换为html一个示例，比如通过如下代码可以将一段 markdown 转换为

markdown： # Hello, *Mercury*!

html： <h1>Hello, <em>Mercury</em>!</h1>

示例代码：

3、remark插件系统

remark-parse— 插件将 markdown 作为输入并将其转换为语法树 (mdast)

remark-stringify— 插件获取语法树（mdast）并将其转换为 markdown 作为输出

remark—unified、remark-parse、remark-stringify在输入和输出为 markdown 时很有用

remark-cli— CLI 用于remark检查和格式化脚本中的 markdown

remark-gfm— 添加对 GFM（GitHub 风格 markdown）的支持

remark-lint— 检查 markdown 并警告不一致之处

remark-toc— 生成目录

remark-collapse – 使某些部分可折叠

remark-breaks— 支持硬中断而不需要空格或转义符。

remark-rehype— 将 markdown 转换为 HTML

remark-directive— 支持指令

remark-frontmatter— 支持前置内容（YAML、TOML 等）

remark-math— 支持数学

remark-html—将 markdown 编译为 HTML 的统一（remark ）插件。当您想将 markdown 转换为 HTML 时，此插件很有用。它是的快捷方式 .use(remarkRehype).use(rehypeSanitize).use(rehypeStringify)。

您可以从现有的 150 多个插件中进行选择。以下是查找插件的三种好方法：