Тег Markdown для названия документа

Нет ли способа указать заголовок документа в документе Markdown?

Я пришел использовать Markdown с Sublime Text для подготовки многих моих личных и деловых документов. Например, я часто хочу иметь заголовок "верхнего уровня", аналогичный стилю Title в Word. Итак, например:

### Things to Do ###

At Home
=======
*    Mow the cat
*    Feed the lawn

At the Office
=============
*    Learn Markdown
*    Use Big-O notation in a clever way

Но линия ### Things to Do ### не соблюдается Markdown, и я не знаю альтернативы. Есть один?

Я мог бы использовать стиль заголовка 1 для названия, а затем заголовок 2 для остальных, но если мне нужно более глубокое вложение заголовков, я быстро исчерпаю глубину. И, в конце концов, название в принципе не является заголовком как таковым. Было бы неплохо, например, если маркеры Markdown-to-HTML использовали Title для страницы <title>, а также для заголовка верхнего уровня a la Word.

Ответы

Ответ 1

Одним из интересных моментов дизайна Markdown является то, что HTML явно разрешен. HTML5 добавил семантические разделы страницы, включая <header> и <main> , который может быть подходящим для заголовка вашей страницы.

Например:

<header>
Things to Do
============
</header>
<main>
At Home
=======
*    Mow the cat
*    Feed the lawn

At the Office
=============
*    Learn Markdown
*    Use Big-O notation in a clever way
</main>

Если исключить HTML предпочтительнее, вы можете использовать заголовки в стиле Atx, чтобы получить более двух уровней иерархии.

Например:

# Things to Do

## At Home
*    Mow the cat
*    Feed the lawn

## At the Office
### Morning
*    Learn Markdown
*    Use Big-O notation in a clever way
### Afternoon
*    Read e-mails
*    Scrutinize LOLcats

Ответ 2

Если вы имеете в виду уделение pandoc, то самым простым способом является использование "%", например

% Document Title

# Header 1

content

## Header 2

## Header 2

см. http://pandoc.org/README.html#metadata-blocks для получения дополнительной информации об уценке pandoc.

Ответ 3

Метаданные заголовков

Если вы используете MultiMarkdown, вы можете добавить некоторые метаданные в верхней части документа

format: complete
title: This is a title for the web-page
css: http://example.com/main.css

First line of visible text

Название будет включено в <title> в разделе <head>

Вы можете также включить его по ссылке в теле с помощью [%title])

Под-подзаголовки

Не должно быть никаких проблем при распознавании ### в начале первой строки в качестве заголовка уровня 3 для генерации тегов <h3>. Я использую это в нескольких реализациях Markdown/MultiMarkdown

Вы можете протестировать его, используя John Gruber Dingus, Markable и т.д.

Смещение заголовка

По крайней мере, некоторые реализации Markdown/Multimarkdown позволяют вам указать смещение для сгенерированных заголовков, чтобы оно генерировало <h2> и <h3> вместо <h1> и <h2>.

Это позволит вам помещать, например, <h1>Title</h1> или <h1>[%title]</h1> в качестве первой строки вашего документа (после объявлений метаданных).