commonmark-java

commonmark-java

用于根据 [CommonMark] 规范（以及一些扩展）解析和渲染 [Markdown] 文本的 Java 库。 简介

提供用于将输入解析为抽象语法树（AST）、访问和操作节点，以及渲染为 HTML 或还原为 Markdown 的类。 它最初是 [commonmark.js] 的一个移植版本，但此后已发展成为一个具有以下功能的可扩展库：

• 小型（核心无依赖，扩展位于独立构件中）
• 快速（比曾流行的 Markdown 库 [pegdown] 快 10-20 倍，参见仓库中的基准测试）
• 灵活（解析后可操作 AST，自定义 HTML 渲染）
• 可扩展（支持表格、删除线、自动链接等，详见下文）

该库支持 Java 11 及更高版本。它也适用于 Android，但属于尽力而为，请报告问题。对于 Android，最低 API 级别为 19，请参见 目录。

核心库坐标（全部见 [Maven Central]）：

<dependency>
    <groupId>org.commonmark</groupId>
    <artifactId>commonmark</artifactId>
    <version>0.30.0</version>
</dependency>

在 Java 9 中使用的模块名是 org.commonmark、org.commonmark.ext.autolink 等，与包名对应。

请注意，对于此库的 0.x 版本，API 尚不稳定，可能在次版本之间发生破坏性变更。在 1.0 之后，将遵循[语义化版本控制]。包含 beta 的包意味着其 API 尚不受稳定保证约束；但在正常使用中，通常不需要使用这些包。

请参阅 spec.txt 文件，了解当前实现的规范版本。还可以查看 [CommonMark dingus] 以熟悉语法或尝试边缘情况。如果克隆了仓库，还可以使用 DingusApp 类进行交互式尝试。

commonmark-android-test