Markdown

Markdown — облечённый язык разметки, предназначенный для вёрстки содержимого страниц. Хорошо подходит для наполнения сайта благодаря ряду преимуществ.

Преимущества перед HTML

Наполнение содержимого внутренних страниц сайта с помощью «голого» HTML позволяет полностью контролировать форматирование размещаемой информации. В тоже время HTML-код неестественен для восприятия человеком; простому пользователю будет довольно сложно наполнять сайт таким способом. Использование Markdown позволяет значительно упростить восприятие текста, не теряя при этом контроля над форматированием страницы.

Если требуется вставить сложные HTML-элементы, которые невозможно сверстать с помощью Markdown, то можно вставить HTML-код прямо в текст — Markdown позволяет это сделать.

Преимущества перед визуальными редакторами

В большинство систем управления сайтом (CMS) встроены визуальные редакторы, которые позволяют изменять форматирование текста и сразу же видеть результат. Это очень удобно, отпадает необходимость изучать HTML.

В то же время большинство визуальных редакторов генерирует очень некачественный замусоренный HTML-код. Это с одной стороны приводит к визуальным ошибкам, а с другой — может негативно сказаться на продвижении сайта.

Пример HTML-кода, сгенерированного визуальным редактором
Пример HTML-кода, сгенерированного визуальным редактором

Markdown лишен недостататков визуальных редакторов и позволяет генерировать чистый и качественный HTML-код. Синтаксис Markdown довольно прост и не должен вызвать сложностей у большинства пользователей.

Синтаксис

Руководство по использованию Markdown вы можете найти на официальном сайте. Ниже приведена подборка по использованию популярных элементов оформления текста.

Курсив

Для того, чтобы добавить курсивное начертание для текста, оберните его в символ звёздочки: *курсив*.

Жирный

Для того, чтобы добавить жирное начертание для текста, обените его в два символа звёздочки: **жирный**.

Жирный + курсив

Для того, чтобы добавить одновременно и жирное, и курсивное начертание для текста, обените его в три символа звёздочки: ***жирный + курсив***.

Заголовок

Для добавления заголовка поместите перед текстом символ решётки. Число повторений символа соответствует уровню заголовку. Допускается использовать заголовки до шестого уровня включительно.

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

Для первых двух уровне заголовка можно также использовать другой синтаксис.

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

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

Цитата

Для того, чтобы процитировать какой-либо текст, добавьте перед ним знак «больше».

> Пример цитаты

Нумерованный список

1. Первый элемент нумерованного списка.
2. Элемент №2 этого же списка.
3. Элемент №3 списка.

Ненумерованный список

- Элемент ненумерованного списка.
- Элемент №2.
- Элемент №3.

Ссылка

Для вставки ссылки заключите её текст (анкор) в квадратные скобки, а саму ссылку укажите после в круглых скобках: [Текст ссылки](http://адрес.сайта).

Также некоторые разновидности Markdown, в частности, используемая в ParaCMS, позволяют вставить ссылку, просто указав её в тексте: http://адрес.сайта.

Изображение

Для вставки изображения поставьте знак восклицания, добавьте альтернативный текст в квадратных скобках, а после вставьте ссылку на изображение также в квадратных скобках: ![Альтернативный текст][http://адрес.изображения].

Пример использования

Исходный Markdown-код

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

Текст в **Markdown** можно разбивать на параграфы. Параграфы должна разделять пустая строка.

Это другой параграф. В тексте допустимо использовать **полужирное**, *курсивное*, а также
***смешанное*** начертание. 

Попробуем создать ненумерованный список:

- Элемент списка № 1.
- Элемент списка № 2.
- Элемент списка № 3.

А теперь нумерованный список:

1. Элемент списка № 1.
2. Элемент списка № 2.
3. Элемент списка № 3.

И напоследок вставим ссылку на сайт [веб-студии](https://paraus.ru/).

Результат

Заголовок четвёртого уровня

Текст в Markdown можно разбивать на параграфы. Параграфы должна разделять пустая строка.

Это другой параграф. В тексте допустимо использовать полужирное, курсивное, а также смешанное начертание.

Попробуем создать ненумерованный список:

  • Элемент списка № 1.
  • Элемент списка № 2.
  • Элемент списка № 3.

А теперь нумерованный список:

  1. Элемент списка № 1.
  2. Элемент списка № 2.
  3. Элемент списка № 3.

И напоследок вставим ссылку на сайт веб-студии.