Руководство с примерами по написанию постов на Jekyll markdown: kramdown

Сюда можно подсматривать когда пишу новый пост, пока не запомню.

Собираю здесь фрагменты кода и полезные ссылки для написания постов на языке markdown: kramdown. Вставляю только заголовки, примеры синтаксиса, иногда короткое описание.

Заголовки

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

#  Заголовок первого уровня
### Заголовок третьего уровня
###### Заголовок шестого уровня

#  Заголовок первого уровня #
### Заголовок третьего уровня ###
###### Заголовок шестого уровня ######

Цветной текст

Это blue green orange indigo purple pink yellow teal cyan red текст

teal green orange red black yellow

<span class="color-blue">Some</span>
<span class="color-green">cool</span>
<span class="color-orange">colorful</span>
<span class="color-red">text.</span><br>

<span class="highlight-teal">teal</span>
<span class="highlight-green">green</span>
<span class="highlight-orange">orange</span>
<span class="highlight-red">red</span>
<span class="highlight-black">black</span>
<span class="highlight-yellow">yellow</span>

Цитаты

> Первый уровень цитирования
>> Второй уровень цитирования
>>> Третий уровень цитирования
>
>Первый уровень цитирования

Списки

* Проводник
+ Полупроводник
- Диэлектрик

1. Проводник
2. Полупроводник
3. Диэлектрик

Горизонтальные

Первая часть текста, который необходимо разделить
***
Вторая часть текста, который необходимо разделить

Первая часть текста, который необходимо разделить

-- -- -  -- --- 

Вторая часть текста, который необходимо разделить

Ссылки

[название](http://example.com/ "Необязательная подсказка при наведении")

<http://example.com/>

В результате на экран выводится следующее: http://example.com/

<address@example.com>

Локальные сноски по id

[название] [id]:

В этом случае возможно определить идентификатор в любом месте документа

[id]: http://example.com/ "Необязательная подсказка"

Выделение

*курсив*
_курсив_

**полужирный**
__полужирный__

***полужирный курсив***
___полужирный курсив___

Изображения

![Альтернативный текст](/путь/к/изображению.jpg "Необязательная подсказка")

![Альтернативный текст][id]

[id]: путь/к/изображению "Необязательная подсказка"

Квадратные скобки, в которых указывается альтернативный изображению текст (он станет содержимым атрибута в элементе img)

Markdown не позволяет задать размеры изображения (ширину, высоту)

Обратный слеш

Может употребляться в Markdown перед специальными символами для того, чтобы они воспринимались в их буквальном (а не служебном) значении.

Присвоить класс фрагменту кода

orange

yellow

green

teal

orange text

teal
{: .color-teal}

orange text
{: .highlight-orange}