Latest 3.0.3
Homepage https://github.com/hoedown/hoedown
License MIT
Authors , , ,

Hoedown

Build Status

Hoedown is a revived fork of Sundown,
the Markdown parser based on the original code of the
Upskirt library
by Natacha Porté.

Features

  • Fully standards compliant

    Hoedown passes out of the box the official Markdown v1.0.0 and v1.0.3
    test suites, and has been extensively tested with additional corner cases
    to make sure its output is as sane as possible at all times.

  • Massive extension support

    Hoedown has optional support for several (unofficial) Markdown extensions,
    such as non-strict emphasis, fenced code blocks, tables, autolinks,
    strikethrough and more.

  • UTF-8 aware

    Hoedown is fully UTF-8 aware, both when parsing the source document and when
    generating the resulting (X)HTML code.

  • Tested & Ready to be used on production

    Hoedown has been extensively security audited, and includes protection against
    all possible DOS attacks (stack overflows, out of memory situations, malformed
    Markdown syntax…).

    We’ve worked very hard to make Hoedown never leak or crash under any input.

    Warning: Hoedown doesn’t validate or post-process the HTML in Markdown documents.
    Unless you use HTML_ESCAPE or HTML_SKIP, you should strongly consider using a
    good post-processor in conjunction with Hoedown to prevent client-side attacks.

  • Customizable renderers

    Hoedown is not stuck with XHTML output: the Markdown parser of the library
    is decoupled from the renderer, so it’s trivial to extend the library with
    custom renderers. A fully functional (X)HTML renderer is included.

  • Optimized for speed

    Hoedown is written in C, with a special emphasis on performance. When wrapped
    on a dynamic language such as Python or Ruby, it has shown to be up to 40
    times faster than other native alternatives.

  • Zero-dependency

    Hoedown is a zero-dependency library composed of some .c files and their
    headers. No dependencies, no bullshit. Only standard C99 that builds everywhere.

  • Additional features

    Hoedown comes with a fully functional implementation of SmartyPants,
    a separate autolinker, escaping utilities, buffers and stacks.

Bindings

You can see a community-maintained list of Hoedown bindings at
the wiki. There is also a
migration guide
available for authors of Sundown bindings.

Help us

Hoedown is all about security. If you find a (potential) security vulnerability in the
library, or a way to make it crash through malicious input, please report it to us by
emailing the private Hoedown Security
mailing list. The Hoedown security team will review the vulnerability and work with you
to reproduce and resolve it.

Unicode character handling

Given that the Markdown spec makes no provision for Unicode character handling, Hoedown
takes a conservative approach towards deciding which extended characters trigger Markdown
features:

  • Punctuation characters outside of the U+007F codepoint are not handled as punctuation.
    They are considered as normal, in-word characters for word-boundary checks.

  • Whitespace characters outside of the U+007F codepoint are not considered as
    whitespace. They are considered as normal, in-word characters for word-boundary checks.

Install

Just typing make will build Hoedown into a dynamic library and create the hoedown
and smartypants executables, which are command-line tools to render Markdown to HTML
and perform SmartyPants, respectively.

If you are using CocoaPods, just add the line pod 'hoedown' to your Podfile and call pod install.

Or, if you prefer, you can just throw the files at src into your project.

Latest podspec

{
    "name": "hoedown",
    "version": "3.0.3",
    "summary": "Standards compliant, fast, secure markdown processing library in C. A fork of sundown.",
    "homepage": "https://github.com/hoedown/hoedown",
    "license": "MIT",
    "authors": {
        "Natacha Porte": "",
        "Vincent Marti": "",
        "Devin Torres and the hoedown authors": "[email protected]",
        "Clemens Gruber (podspec)": "[email protected]"
    },
    "source": {
        "git": "https://github.com/hoedown/hoedown.git",
        "tag": "3.0.3"
    },
    "requires_arc": false,
    "default_subspecs": "standard",
    "subspecs": [
        {
            "name": "standard",
            "source_files": "src/*.{c,h}"
        }
    ]
}

Pin It on Pinterest

Share This