MKD_FUNCTIONS(3)

NAME
mkd_functions - access and process Markdown documents.

LIBRARY
Markdown (libmarkdown, -lmarkdown)

SYNOPSIS
#include <mkdio.h>
int
mkd_compile(MMIOT *document, int flags);
int
mkd_style(MMIOT *document, FILE *output);
int
mkd_document(MMIOT *document, char **doc);
int
mkd_generatehtml(MMIOT *document, FILE *output);
int
mkd_xhtmlpage(MMIOT *document, int flags, FILE *output);
int
mkd_toc(MMIOT *document, char **doc);
void
mkd_generatetoc(MMIOT *document, FILE *output);
void
mkd_cleanup(MMIOT*);
char*
mkd_doc_title(MMIOT*);
char*
mkd_doc_author(MMIOT*);
char*
mkd_doc_date(MMIOT*);

DESCRIPTION

The markdown format supported in this implementation includes Pandoc-style header and inline <style> blocks, and the standard markdown(3) functions do not provide access to the data provided by either of those extensions. These functions give you access to that data, plus they provide a finer-grained way of converting Markdown documents into HTML.

Given a MMIOT* generated by mkd_in() or mkd_string(), mkd_compile() compiles the document into <style>, Pandoc, and html sections.

Once compiled, the document can be examined and written by the mkd_style(), mkd_document(), mkd_generatehtml(), mkd_toc(), mkd_generatetoc(), mkd_xhtmlpage(), mkd_doc_title(), mkd_doc_author(), and mkd_doc_date() functions. The mkd_style() writes any <style> sections to the output, mkd_document() points text to the text of the document and returns the size of the document, mkd_generatehtml() writes the rest of the document to the output, and mkd_doc_title(), mkd_doc_author(), mkd_doc_date() are used to read the contents of a Pandoc header, if any.

mkd_xhtmlpage() writes a xhtml page containing the document. The regular set of flags can be passed.

mkd_toc() writes a document outline, in the form of a collection of nested lists with links to each header in the document, into a string allocated with malloc(), and returns the size.

mkd_generatetoc() is like mkd_toc(), except that it writes the document outline to the given FILE* argument.

mkd_cleanup() deletes a MMIOT* after processing is done.

mkd_compile() accepts the same flags that markdown() and mkd_string() do;
MKD_NOIMAGE
    Do not process `![]' and remove <img> tags from the output.
MKD_NOLINKS
    Do not process `[]' and remove <a> tags from the output.
MKD_NOPANTS
    Do not do Smartypants-style mangling of quotes, dashes, or ellipses.
MKD_TAGTEXT
    Process the input as if you were inside a html tag. This means that no html tags will be generated, and mkd_compile() will attempt to escape anything that might terribly confuse a web browser.
MKD_NO_EXT
    Do not process any markdown pseudo-protocols when handing [][] links.
MKD_NOHEADER
    Do not attempt to parse any Pandoc-style headers.
MKD_TOC
    Label all headers for use with the mkd_generatetoc() function.
MKD_1_COMPAT
    MarkdownTest_1.0 compatability flag; trim trailing spaces from the first line of code blocks and disable implicit reference links.

RETURN VALUES
The functions mkd_compile(), mkd_style(), and mkd_generatehtml() return 0 on success, -1 on failure.

SEE ALSO
markdown(1), markdown(3), markdown(7), mkd-extensions(7), mmap(2).

http://daringfireball.net/projects/markdown/syntax

BUGS
Error handling is minimal at best.