Использование Markdown в Albireo Framework

© GitHub-Flavored Markdown

См. файл albireo-data/pages/sample/md.php


Краткое руководство

Абзацы создаются при помощи пустой строки. Если вокруг текста сверху и снизу есть пустые строки, то текст превращается в абзац.

Чтобы сделать перенос строки вместо абзаца,
нужно поставить два пробела в конце предыдущей строки.

Заголовки отмечаются диезом # в начале строки, от одного до шести. Например:

Заголовок первого уровня

Заголовок h2

Заголовок h3

Заголовок h4

Заголовок h5
Заголовок h6

В декоративных целях заголовки можно «закрывать» с обратной стороны.

Списки

Для разметки неупорядоченных списков можно использовать или *, или -, или +:

Вложенные пункты создаются четырьмя пробелами перед маркером пункта:

Упорядоченный список:

  1. элемент 1
  2. элемент 2
    1. вложенный
    2. вложенный
  3. элемент 3
  4. Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

На самом деле не важно как в коде пронумерованы пункты, главное, чтобы перед элементом списка стояла цифра (любая) с точкой. Можно сделать и так:

  1. элемент 1
  2. элемент 2
  3. элемент 3
  4. элемент 4

Список с абзацами:

Цитаты

Цитаты оформляются как в емейлах, с помощью символа >.

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisseid sem consectetuer libero luctus adipiscing.

Или более ленивым способом, когда знак > ставится перед каждым элементом цитаты, будь то абзац, заголовок или пустая строка:

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisseid sem consectetuer libero luctus adipiscing.

В цитаты можно помещать всё что угодно, в том числе вложенные цитаты:

This is a header.

  1. This is the first list item.
  2. This is the second list item.

Вложенная цитата.

Here's some example code:

<code>return shell_exec("echo $input | $markdown_script");</code>

Исходный код

В чистом Маркдауне блоки кода отбиваются 4 пробелами в начале каждой строки.

Но в GitHub-Flavored Markdown (сокращенно GFM) есть более удобный способ: ставим по три апострофа (на букве Ё) до и после кода. Также можно указать язык исходного кода.

<code class="language-html"><nav class="nav nav-primary">
  <ul>
    <li class="tab-conversation active">
      <a href="#" data-role="post-count" class="publisher-nav-color" data-nav="conversation">
        <span class="comment-count">0 комментариев</span>
        <span class="comment-count-placeholder">Комментарии</span>
      </a>
    </li>
    <li class="dropdown user-menu" data-role="logout">
      <a href="#" class="dropdown-toggle" data-toggle="dropdown">
        <span class="dropdown-toggle-wrapper">
          <span>
            Войти
          </span>
        </span>
        <span class="caret"></span>
      </a>
    </li>
  </ul>
</nav></code>

Самое приятное, что в коде не нужно заменять угловые скобки < > и амперсанд & на их html-сущности.

Инлайн код

Для вставки кода внутри предложений нужно заключать этот код в апострофы (на букве Ё). Пример: <html class="ie no-js">.

Если внутри кода есть апостроф, то код надо обрамить двойными апострофами: There is a literal backtick (`) here.

Горизонтальная черта

hr создается тремя звездочками или тремя дефисами.


Ссылки

Это встроенная ссылка с title элементом. Это — без title.

А вот пример нескольких ссылок с разметкой как у сносок. Прокатит и короткая запись без указания id.

Вынос длинных урлов из предложения способствует сохранению читабельности исходника. Сноски можно располагать в любом месте документа.

Emphasis

Выделять слова можно при помощи * и _. Одним символ для наклонного текста, два символа для жирного текста, три — для наклонного и жирного одновременно.

Например, это italic и это тоже italic. А вот так уже strong, и так тоже strong. А так жирный и наклонный одновременно.

Зачеркивание

В GFM добавлено зачеркивание текста: две тильды ~ до и после текста.

Зачеркнуто

Картинки

Картинка без alt текста

Картинка с альтом и тайтлом:

Alt text

Запомнить просто: синтаксис как у ссылок, только перед открывающей квадратной скобкой ставится восклицательный знак.

Картинки «сноски»:

КартинкаКартинкаКартинка

Картинки-ссылки:

Alt text

Использование HTML внутри Markdown

Mожно смешивать Markdown и HTML. Если на какие-то элементы нужно поставить классы или атрибуты, смело используем HTML:

Выделять слова можно при помощи * и _ . Например, это italic и это тоже italic. А вот так уже strong, и так тоже strong.

Можно и наоборот, внутри HTML-тегов использовать Маркдаун.

Пример Маркдауна внутри HTML

Выделять слова можно при помощи * и _ . Например, это italic и это тоже italic. А вот так уже strong, и так тоже strong.

Таблицы

В чистом Маркдауне нет синтаксиса для таблиц, а в GFM есть.

First HeaderSecond Header
Content CellContent Cell
Content CellContent Cell

Для красоты можно и по бокам линии нарисовать:

First HeaderSecond Header
Content CellContent Cell
Content CellContent Cell

Можно управлять выравниванием столбцов при помощи двоеточия.

Left-AlignedCenter AlignedRight Aligned
col 3 issome wordy text$1600
col 2 iscentered$12
zebra stripesare neat$1

Внутри таблиц можно использовать ссылки, наклонный, жирный или зачеркнутый текст.

Для всего остального есть обычный HTML.