03 June 2013

CSS: style.css Use numbered headers: true HTML use syntax: true LaTeX use listings: true LaTeX CJK: false LaTeX preamble: preamble.tex

Maruku features

Maruku allows you to write in an easy-to-read-and-write syntax, like this:

This document in Markdown

Then it can be translated to HTML:

This document in HTML

or LaTeX, which is then converted to PDF:

This document in PDF

Maruku implements:

the original Markdown syntax (HTML or PDF), translated by Maruku).
all the improvements in PHP Markdown Extra.
a new meta-data syntax

Table of contents: (auto-generated by Maruku!)

Maruku summary of features
Examples of PHP Markdown Extra syntax

Maruku summary of features

Supported syntax
Output
- XHTML
  - Syntax highlighting via the syntax library.
- LaTeX
  - Translation of HTML entities to LaTeX
  - Syntax highlighting via the listings package.
Misc
- Documentation for supported attributes
- Automatic generation of the TOC

Experimental features (not released yet)

LaTeX Math syntax (not enabled by default)
An extension system for adding new syntax is available, but the API is bound to change in the future, so please don’t use it.
LaTeX to MathML using either one of ritex, itex2mml, blahtex.
LaTeX to PNG using blahtex.

New meta-data syntax

Maruku implements a syntax that allows to attach “meta” information to objects.

See this proposal for how to attach metadata to the elements.

See the documentation for supported attributes.

Meta-data for the document itself is specified through the use of email headers:

Title: A simple document containing meta-headers
CSS: style.css

Content of the document

When creating the document through

Maruku.new(s).to_html_document

the title and stylesheet are added as expected.

Meta-data keys are assumed to be case-insensitive.

Automatic generation of the table of contents

If you create a list, and then set the toc attribute, when rendering Maruku will create an auto-generated table of contents.

* This will become a table of contents (this text will be scraped).
{:toc}

You can see an example of this at the beginning of this document.

Use HTML entities

If you want to use HTML entities, go on! We will take care of the translation to LaTeX:

Entity	Result
`©`	©
`£`	£
`λ`	λ
`—`	—

See the list of supported entities (pdf).

This header contains emphasis strong text and `code`

Note that this header contains formatting and it still works, also in the table of contents.

And This is a link with all sort of weird stuff in the text.

Examples of PHP Markdown Extra syntax

tables

Col1 | Very very long head | Very very long head|
-----|:-------------------:|-------------------:|
cell | center-align        | right-align        |

Col1	Very very long head	Very very long head
cell	center-align	right-align

footnotes ¹

* footnotes [^foot]

[^foot]: I really was missing those.

Markdown inside HTML elements

<div markdown="1" style="border: solid 1px black">
   This is a div with Markdown **strong text**
</div>

This is a div with Markdown strong text

header ids
```
## Download ##     {#download}
```
For example, a link to the download header.
definition lists
```
Definition list
: something very hard to parse
```
Definition list

something very hard to parse
abbreviations or ABB for short.

I really was missing those.
↩

Maruku Syntax