На данную страницу я буду заходить, когда что-то буду менять в сайте. Надо же где-то проверять, что сломалось на этот раз.

Markdown - это легковесный язык разметки текста для веба. Был создан для удобства чтения и написания размеченных текстов. Движок markdown генерирует валидный XHTML. Авторы - John Gruber и Aaron Swartz. Официальная страница проекта и более подробная документация на сайте Daring Fireball.

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

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

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

Параграф выделяется пустой строкой снизу и сверху текста:

<пустая строка>
Текст параграфа. Может быть
разбит на несколько строк.
<пустая строка>

Так же есть "умные дроби". Например, 4/5 пребразуется в 4/5.

Так же ест пребразование дефисов в короткое тире и тире: кое-что (дефис, клавиша на клавиатуре). 2010--2012 век живи --- век учись (тире)

кое-что (дефис, клавиша на клавиатуре).
2010--2012
век живи --- век учись (тире)

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

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

## Заголовок h2

### Заголовок h3

#### Заголовок h4

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

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

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

Заголовок h2

Заголовок h3

Заголовок h4

Заголовок h5

Заголовок h6

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

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

## Заголовок второго уровня

Списки

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

- элемент 1
- элемент 2
- элемент ...

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

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

- элемент 1
- элемент 2
  - вложенный элемент 2.1
  - вложенный элемент 2.2
- элемент ...

элемент 1
элемент 2
- вложенный элемент 2.1
- вложенный элемент 2.2
элемент ...

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

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
элемент 2
1. вложенный
2. вложенный
элемент 3
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

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

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

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

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

- Раз абзац. Lorem ipsum dolor sit amet, consectetur adipisicing elit.

- Два абзац. Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

- Три абзац. Ea, quis, alias nobis porro quos laborum minus sed fuga odio dolore natus quas cum enim necessitatibus magni provident non saepe sequi?

  Четыре абзац (Четыре пробела в начале или один tab).

Раз абзац. Lorem ipsum dolor sit amet, consectetur adipisicing elit.
Два абзац. Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.
Три абзац. Ea, quis, alias nobis porro quos laborum minus sed fuga odio dolore natus quas cum enim necessitatibus magni provident non saepe sequi?

Четыре абзац (Четыре пробела в начале или один tab).

Цитаты

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

> 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. Suspendisse
> id 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. Suspendisse id 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. Suspendisse
> id 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. Suspendisse id 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:
>
>     return shell_exec("echo $input | $markdown_script");

This is a header.

This is the first list item.

This is the second list item.

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

Here's some example code:
  return shell_exec("echo $input | $markdown_script");
В чистом Маркдауне блоки кода отбиваются 4 пробелами в начале каждой строки.

Есть более удобный способ: ставим по три апострофа (на букве Ё) до и после кода. Также можно указать язык исходного кода.

    ```html
    <nav class="nav nav-primary">
        ...
    </nav>
    ```

<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>

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

Инлайн код

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

`<html class="ie no-js">`
``There is a literal backtick (`) here.``

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

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

---
---

---

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

Сноски

Быстрая, коричневая лиса[^1], перепрыгнула через ленивого пса[^2].

[^1]: Лисицы красные

[^2]: Собаки обычно не красные :)

Быстрая, коричневая лиса¹, перепрыгнула через ленивого пса².

Так же пример есть в разделе со ссылками

Ссылки

Это встроенная ссылка с title элементом. Это — без title. Это - короткая запись http://example.com/link

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

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

> [one]: http://example.com/ "Опциональный заголовок"
> [two]: http://example.com/some
> [id]: http://example.com/links "Опциональный заголовок"
> [короткая запись]: http://example.com/short

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

Emphasis

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

Например, это italic и это тоже italic. А вот так уже strong, и так тоже strong. А так жирный и наклонный одновременно. Пример экранирования - **очень выделенный** текст

Например, это _italic_ и это тоже _italic_.
А вот так уже **strong**, и так тоже **strong**.
А так **_жирный и наклонный_** одновременно.
Пример экранирования - \*\*очень выделенный\*\* текст

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

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

~~Зачеркнуто~~

~~Зачеркнуто~~

Картинки

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

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

Alt text

![](//placehold.it/150x100)
![Alt text](//placehold.it/150x100 "Можно задать title")

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

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

Картинка

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

![Картинка][image1]
![Картинка][image2]
![Картинка][image3]

[image1]: //placehold.it/250x100
[image2]: //placehold.it/200x100
[image3]: //placehold.it/150x100

//Картинка-ссылка
[![Alt text](//placehold.it/150x100)](http://example.com/)

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

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

Выделять слова можно при помощи \* и \_ .
Например, это <em class="a1">italic</em> и это тоже <i class="a1">italic</i>.
А вот так уже <b>strong</b>, и так тоже <strong>strong</strong>.

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

<section class="someclass">
  ### Пример Маркдауна внутри HTML Выделять слова можно при помощи `*` и `_` . Например, это
  _italic_ и это тоже *italic*. А вот так уже __strong__, и так тоже **strong**.
</section>

Таблицы

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

First Header	Second Header
Content Cell	Content Cell
Content Cell	Content Cell

| First Header | Second Header |
| ------------ | ------------- |
| Content Cell | Content Cell  |
| Content Cell | Content Cell  |

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

First Header	Second Header
Content Cell	Content Cell
Content Cell	Content Cell

| First Header | Second Header |
| ------------ | ------------- |
| Content Cell | Content Cell  |
| Content Cell | Content Cell  |

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

Left-Aligned	Center Aligned	Right Aligned
col 3 is	some wordy text	$1600
col 2 is	centered	$12
zebra stripes	are neat	$1

| Left-Aligned  | Center Aligned  | Right Aligned |
| :------------ | :-------------: | ------------: |
| col 3 is      | some wordy text |     **$1600** |
| col 2 is      |    centered     |           $12 |
| zebra stripes |    are neat     |        ~~$1~~ |

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

a task list item
list syntax required
incomplete
completed

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

MathJax

{{< tex >}}E = mc^2{{< /tex >}}

{{< tex >}}b + y = \sqrt{f} = \sum_n^5 {x}{{< /tex >}}

Here's sum inline math:. Display mode math looks like: {{< tex >}}E = mc^2{{< /tex >}} Убрать пробелы возле < >

https://github.com/grishy/blog/blob/hugo/content/post/checking-the-features.md

Лисицы красные ↩
Собаки обычно не красные :) ↩

Страница проверки сайта - Markdown