Markdown tag for document title

Question

Is there no way to indicate the document title in a Markdown document?

I've come to use Markdown with Sublime Text to prepare many of my personal and business documents. I often want to have a kind of "top level" heading analogous to the Title style in Word, for example. So, for example:

### Things to Do ###  At Home ======= *    Mow the cat *    Feed the lawn  At the Office ============= *    Learn Markdown *    Use Big-O notation in a clever way 

But the ### Things to Do ### line is not respected by Markdown, and I don't know an alternative. Is there one?

I could use the Heading 1 style for the title and then Heading 2 for the rest, but if I need a deeper nesting of headings, I quickly run out of depth. And, after all, a title fundamentally isn't a heading per se. It would be nice, for example, if Markdown-to-HTML parsers used the Title for the page <title> as well as for a top-of-page header a la Word titles.

Answer 1

If you are referring to pandoc markdown specifically the simplest approach is to use '%', e.g.

% Document Title  # Header 1  content  ## Header 2  ## Header 2 

see http://pandoc.org/README.html#metadata-blocks for more information on pandoc markdown.