cmark-gfm

我目前正在Swift中开发一个CommonMark框架。我没有自己编写解析器，而是决定使用Github的cmark分支，即CommonMark的C参考实现。

通过查看使用cmark的其他库和阅读cmark源代码，我找到了使用cmark所需的大部分知识。我不太清楚的一件事是如何为表、删除线、自动链接和标签过滤启用gfm扩展。从我找到的文档来看，这一点并不明显。

经过反复试验和阅读cmark源代码后，我发现有必要首先调用:

core_extensions_ensure_registered()

然后你需要使用以下方法将扩展附加到你的解析器:

cmark_parser_attach_syntax_extension(parser, extension)

为此，您需要使用流接口，而不是简单的cmark_parse_document接口。

如何在Swift中做到这一点的例子:

core_extensions_ensure_registered()

guard let parser = cmark_parser_new(options.rawValue) else {
    return
}

defer {
    cmark_parser_free(parser)
}

if let tableExtension = cmark_find_syntax_extension("table") {
    cmark_parser_attach_syntax_extension(parser, tableExtension)
}

if let autolinkExtension = cmark_find_syntax_extension("autolink") {
    cmark_parser_attach_syntax_extension(parser, autolinkExtension)
}

if let extension = cmark_find_syntax_extension("strikethrough") {
    cmark_parser_attach_syntax_extension(parser, extension)
}

cmark_parser_feed(parser, text, text.utf8.count)

guard let cmarkNode = cmark_parser_finish(parser) else {
    return
}

下面是一个在启用标签过滤扩展的情况下将cmark节点呈现为HTML的示例。这假设您已经在某个时刻调用了core_extensions_ensure_registered()。

var extensions: UnsafeMutablePointer<cmark_llist>? = nil

if let tagfilter = cmark_find_syntax_extension("tagfilter") {
    extensions = cmark_llist_append(cmark_get_default_mem_allocator(), nil, tagfilter)
}

guard let buffer = cmark_render_html(cmarkNode, options.rawValue, extensions) else {
    return
}

defer {
    free(buffer)
}

guard let html = String(validatingUTF8: buffer) else {
    return
}

// use the filtered html

我仍然在做我的CommonMark库的第一个版本，但是我有一个Swift兼容的框架可以直接使用cmark-gfm。它与Carthage, CocoaPods和Swift Package Manager一起工作。可以在https://github.com/KristopherGBaker/libcmark_gfm上找到它。

Carthage

github "KristopherGBaker/libcmark_gfm" ~> 0.28.0

CocoaPods

pod 'libcmark_gfm'