cmark: Fast, accurate CommonMark (Markdown) parser and renderer

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

Warnings:

'ghc-options: -O2' is rarely needed. Check that it is giving a real benefit and not just imposing longer compile times on your users.
Packages relying on Cabal 1.12 or later should specify a specific version of the Cabal spec of the form 'cabal-version: x.y'. Use 'cabal-version: 1.14'.

This package provides Haskell bindings for libcmark, the reference parser for CommonMark, a fully specified variant of Markdown. It includes sources for libcmark (0.28.0) and does not require prior installation of the C library.

[Skip to Readme]

Properties

Versions	0.1.0.0, 0.1.0.1, 0.2, 0.2.0.1, 0.2.0.2, 0.3, 0.3.0.1, 0.3.1, 0.3.2, 0.3.3, 0.3.3.1, 0.3.4, 0.3.5, 0.4.0.1, 0.4.1, 0.5.0, 0.5.1, 0.5.2, 0.5.2.1, 0.5.3, 0.5.3.1, 0.5.4, 0.5.5, 0.5.5.1, 0.5.6, 0.5.6.1, 0.5.6.1, 0.5.6.3, 0.6, 0.6.1
Change log	changelog
Dependencies	base (>=4.5 && <5.0), bytestring, ghc-prim (>=0.2), text (>=1.0 && <1.3) [details]
License	BSD-3-Clause
Copyright	(C) 2015--17 John MacFarlane
Author	John MacFarlane
Maintainer	jgm@berkeley.edu
Category	Text
Home page	https://github.com/jgm/cmark-hs
Source repo	head: git clone git://github.com/jgm/cmark-hs.git
Uploaded	by JohnMacFarlane at 2019-03-11T17:23:01Z

Modules

[Index] [Quick Jump]

CMark

Flags

Automatic Flags

Name	Description	Default
pkgconfig	Use system libcmark via pkgconfig	Disabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

cmark-0.5.6.1.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

JohnMacFarlane

For package maintainers and hackage trustees

edit package information

Readme for cmark-0.5.6.1

[back to package description]

cmark-hs

This package provides Haskell bindings for libcmark, the reference parser for CommonMark, a fully specified variant of Markdown. It includes sources for libcmark and does not require prior installation of the C library.

cmark provides the following advantages over existing Markdown libraries for Haskell:

Speed: cmark can render a Markdown version of War and Peace in the blink of an eye. Conversion speed is on par with the sundown library, though we were unable to benchmark precisely, because sundown raised a malloc error when compiled into our benchmark suite. Relative to other Haskell Markdown libraries: cmark was 82 times faster than cheapskate, 59 times faster than markdown, 105 times faster than pandoc, and 3 times faster than discount.
Memory footprint: Memory footprint is on par with sundown. On one sample, the library uses a fourth the memory that markdown uses, and less than a tenth the memory that pandoc uses.
Robustness: cmark can handle whatever is thrown at it, without the exponential blowups in parsing time that sometimes afflict other libraries. (The input bench/full-sample.md, for example, causes both pandoc and markdown to grind to a halt.) libcmark has been extensively fuzz-tested.
Accuracy: cmark passes the CommonMark spec's suite of over 600 conformance tests.
Standardization: Since there is a spec and a comprehensive suite of tests, we can have a high degree of confidence that any two CommonMark implementations will behave the same. Thus, for example, one could use this library for server-side rendering and commonmark.js for client-side previewing.
Multiple renderers. Output in HTML, groff man, LaTeX, CommonMark, and a custom XML format is supported. And it is easy to write new renderers to support other formats.
Ease of installation: cmark is portable and has minimal dependencies.

cmark does not provide Haskell versions of the whole libcmark API, which is built around mutable cmark_node objects. Instead, it provides functions for converting CommonMark to HTML (and other formats), and a function for converting CommonMark to a Node tree that can be processed further using Haskell.

A note on security: This library does not attempt to sanitize HTML output. We recommend using xss-sanitize to filter the output, or enabling optSafe to filter out all raw HTML and potentially dangerous URLs.

A note on stability: There is a good chance the API will change significantly after this early release.