# README

markdown

Package golang-commonmark/markdown provides a CommonMark-compliant markdown parser and renderer, written in Go.

Installation

go get -u gitlab.com/golang-commonmark/markdown

You can also go get mdtool, an example command-line tool:

go get -u gitlab.com/golang-commonmark/mdtool

Standards support

Currently supported CommonMark spec: v0.28.

Extensions

Besides the features required by CommonMark, golang-commonmark/markdown supports:

Tables (GFM)
Strikethrough (GFM)
Autoconverting plain-text URLs to links
Typographic replacements (smart quotes and other)

Usage

md := markdown.New(markdown.XHTMLOutput(true))
fmt.Println(md.RenderToString([]byte("Header\n===\nText")))

Check out the source of mdtool for a more complete example.

The following options are currently supported:

Name	Type	Description	Default
HTML	bool	whether to enable raw HTML	false
Tables	bool	whether to enable GFM tables	true
Linkify	bool	whether to autoconvert plain-text URLs to links	true
Typographer	bool	whether to enable typographic replacements	true
Quotes	string / []string	double + single quote replacement pairs for the typographer	“”‘’
MaxNesting	int	maximum nesting level	20
LangPrefix	string	CSS language prefix for fenced blocks	language-
Breaks	bool	whether to convert newlines inside paragraphs into `<br>`	false
XHTMLOutput	bool	whether to output XHTML instead of HTML	false

Benchmarks

Rendering spec/spec-0.28.txt on a Intel(R) Core(TM) i5-2400 CPU @ 3.10GHz

BenchmarkRenderSpecNoHTML-4       158     7830071 ns/op    2893954 B/op    18361 allocs/op
BenchmarkRenderSpec-4             145     8189870 ns/op    2896310 B/op    18351 allocs/op
BenchmarkRenderSpecBlackFriday2-4 169     7211729 ns/op    2938768 B/op    19214 allocs/op