English
资源说明：Markdown是一种轻量级的标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成结构化的HTML（超文本标记语言）文档。在Web开发领域，Markdown被广泛用于编写README文件、博客文章、文档注释等，因为它的语法简洁明了，易于人阅读和编写。
"remarkdown"是一个专门为Crystal编程语言设计的Markdown解析器和渲染器的扩展，它是基于Crystal Stdlib中的Markdown库进行开发的。这个扩展的主要目的是添加对GitHub Flavored Markdown (GFM)的支持。GFM是GitHub对原始Markdown语法的一种增强，增加了如表格、自动链接、 strikethrough（删除线）等特性，使得Markdown在GitHub环境下更加实用。
在Crystal中，使用remarkdown库可以方便地处理包含GFM特性的Markdown文本。你需要通过Crystal的包管理工具Shards来安装remarkdown：
```bash
shards add remarkdown
```
安装完成后，你可以在代码中导入并使用remarkdown库，如下所示：
```crystal
require "remarkdown"
markdown_text = <<-MARKDOWN
# 这是一个标题
这里是普通的文本，**加粗**，_斜体_，`代码段`。
- 列表项1
- 列表项2
| 表头1 | 表头2 |
|-------|-------|
| 单元格1 | 单元格2 |
[链接文本](https://example.com)
MARKDOWN
parsed_text = Remarkdown.parse(markdown_text)
puts parsed_text.to_html
```
在上面的代码中，`Remarkdown.parse`方法将Markdown文本解析为一个内部表示，然后`to_html`方法将这个表示转换为HTML，以便在网页或终端上显示。
remarkdown库的亮点在于它提供了对GFM特性的原生支持，例如：
1. **表格**：Markdown中可以使用竖线(`|`)定义表格，用`-`和`|`定义表头和列分隔。
2. **任务列表**：在列表项前添加`[ ]`或`[x]`可以创建待办事项列表。
3. **自定义URL识别**：GFM会自动识别URL并将其转化为链接，无需使用传统的Markdown链接语法。
4. **删除线**：使用`~~`包围文本可以添加删除线效果，表示内容已被废弃或修改。
5. **代码块高亮**：支持通过三个反引号(```)定义代码块，并指定语言，可以实现代码高亮。
使用remarkdown，你可以轻松地在Crystal项目中处理GFM格式的文本，使得文档编写和展示更加便捷和美观。
remarkdown是Crystal开发者处理Markdown和GFM内容的一个强大工具。它简化了与Markdown相关的编程任务，使你能够充分利用GitHub提供的各种Markdown增强功能，从而提高文档质量和开发效率。通过熟悉和掌握remarkdown库，你可以在Crystal项目中构建更富表现力和易读性的文档系统。
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
