remark：转换 Markdown 的神器
date
Mar 14, 2025
AI 摘要
slug
remark-transforms-markdown-to-html
status
Published
tags
github
front-end
summary
remark 是一个使用插件转换 Markdown 的工具。它可以检查和修改您的标记，可以在服务器、客户端、CLI、Deno 等上使用 remark。
另外，remark 还是一个插件生态系统，它使用 markdown 作为结构化数据，特别是 AST（抽象语法树）。AST 使程序可以轻松处理 markdown，我们称这些程序为插件。remark 生态系统包含许多现有插件，当然也可以自己制作插件。
type
Post
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 多个插件中进行选择。以下是查找插件的三种好方法：
awesome-remark— 精选最棒的项目
官方插件列表— 所有插件的列表
remark-plugin主题— GitHub 上的任何带remark-plugin标签的 repo
其中
remark-breaks 是比较好用的一个插件，经常我们 markdown 如下两个段落，使用了这个插件后，转换的 html 能够保留两个段落。转换后
如果不使用的话，这两行文字转换后得到一行文字。
4、remark 样式模板
remark-templates：https://github.com/3mdeb/remark-templates