Standard markdown

Standard markdown is a specification of markdown syntax, together with implementations (stmd) in C and javascript.

The C implementation provides both a library and a standalone program that converts markdown to HTML. It is written in standard C99 and has no library dependencies. (However, if you check it out from the repository, you'll need re2c to generate scanners.c from scanners.re. This is only a build dependency for developers, since scanners.c can be provided in a released source tarball.)

The javascript implementation is a single javascript file that can be linked to an HTML page. A standalone version (using node.js) is also provided (js/markdown), and there is a "dingus" for playing with it interactively. (make dingus will start this.)

The spec contains over 400 embedded examples which serve as conformance tests. To run the tests for stmd, do make test. To run them for another markdown program, say myprog, do make test PROG=myprog. To run the tests for stmd.js, do make testjs.

The source of the spec is spec.txt. This is basically a markdown file, with code examples written in a shorthand form:

.
markdown source
.
expected HTML output
.

To build an HTML version of the spec, do make spec.html. To build a PDF version, do make spec.pdf. Both these commands require that pandoc is installed, and creating a PDF requires a latex installation.