Перейти к содержанию

Синтаксис маркдауна

321123

Отступы и выравнивание

p<. Выравнивание влево
p>. Выравнивание вправо
p=. Выравнивание по центру
p<>. Выравнивание по ширине
p(., p((. Отступ слева на 1em, 2em и т. д.
p)., p)). Отступ справа на 1em, 2em и т. д.

h2()>. Заголовок 2-го уровня, выравнивание вправо, отступ на 1em с обоих сторон
h3=. Заголовок 3-го уровня, выравнивание по центру
p{color:red}. Абзац, цвет: красный.

С попмощью апострофов `текст` будет `обрамлён`.

обрамлёный текст

Заголовки

Для того чтобы написать заголовок в Markdown, необходимо использовать знак # (хэш). Если необходимо несколько уровней то, нужно изменить количество хэшей (#) перед текстом заголовка.

# Заголовок 1

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

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

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

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

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

Списки

Markdown поддерживает оба вида списков. Для организации маркерованного списка используются знаки *, + и -. От них зависит вид маркеров. Чтоб сделать многоуровневый список, нужно будет сделать отступ из пробелов).

* Элемент списка 1
* Элемент списка 2
  * Элемент второго уровня списка 1
  * Элемент второго уровня списка 2
    * Элемент третьего уровня списка 1
    * Элемент третьего уровня списка 2
    * Элемент третьего уровня списка 3

Cнумерованными списками все еще проще:

1. Номер 1
2. Номер 2
3. Номер 3

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

Markdown для этого служат три или более дефиса или звездочки.

* * * (можно звездочки без пробелов)
- - - (можно дефисы без пробелов)

(можно дефисы без пробелов)

Параграфы

В Markdown блок текста автоматически преобразуется в параграф. Для вставки пустой строки необходимо два раза поставить символ переноса строки (нажать на Enter)

Курсивное и жирное выделение

Вобще, оформление текста с Markodown становится очень простым и быстрым. Для курсива необходимо поставить знаки *вокруг текста. Для жирного начертания обрамим текст двумя звездочками, а для жирного курсива - тремя. Алтернативный синтаксис - использование знака _ по тем же правилам.

**полужирный**
_курсив_
***полужирный курсив***
_**полужирный курсив**_
^надстрочный^
~подстрочный~
@код@

полужирный курсив полужирный курсив полужирный курсив ^надстрочный^ ~подстрочный~ @код@

Цитата

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

Это второй абзац текста. Обратите внимание на то, что символом цитирования снабжён также и промежуток между абзацами.

> Это цитата, состоящая из двух абзацев текста. Вы видите, что первый
> абзац состоит из нескольких строк, каждой из которых предшествует
> символ закрывающей угловой скобки.
>
> Это второй абзац текста. Обратите внимание на то, что символом
> цитирования снабжён также и промежуток между абзацами.

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

Это первый уровень цитирования.

Это вложенная цитата.

Возвращаемся на первый уровень цитирования.

> Это первый уровень цитирования.
>
> > Это вложенная цитата.
>
> Возвращаемся на первый уровень цитирования.

Код

Для оформления блока кода используется обратный апостроф ` вокруг кода. Три символа для многострочного кода и один для однострочного:

$a = 5; 
$b = 3; 
$c = $a + $b;

echo $c;

Ссылки

Хорошо, теперь о том, что в Markdown сделать не так просто. Существует два варианта оформления ссылок. Первый - обычная вставка в текст: [Текст ссылки](адрес "Описание") и второй вариант - оформление ссылки в виде сноски. Когда в текст вставляется конструкция вида: [Текст ссылки][Тег1]... Указывающая, что именно в этом место будет располагаться ссылка, а где-нибудь ниже её описание: [Тег1][Адрес ссылки]Результат выполнение будет аналогичен первому варианту, но такое оформление удобнее с точки зрения дальнейшей поддержки и редактирования.

Изображения

Изображения помещаются на страницу также, как и ссылки, с одним отличием: в начале записи используется знак ! ![Alt-текст](Путь к файлу "Подпись")Вставка реального изображения может выглядеть как-то так: ![mountains](/img/mountan.png "Пейзаж с горами")

Таблицы

Создание таблиц с Markdown намного нагляднее, чем в HTML. Форматирование интуитивно понятно, добавлю только что для выравнивания текста внутри ячеек используются знаки : в строке, отделяющей заголовок от основной таблицы.

| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Row 1    | Cell 2   | Cell 3   |
| Row 2    | Cell 5   | Cell 6   |
| Row 3    | Cell 8   | Cell 9   |
Column 1 Column 2 Column 3
Row 1 Cell 2 Cell 3
Row 2 Cell 5 Cell 6
Row 3 Cell 8 Cell 9

Спецсимволы

Ну и напоследок, в качестве бонуса, о спецсимволах. Чтоб вставить в текст, например, знак больше >, а не выделить текст в виде цитаты, необходимо поставить перед ним обратный слеш () вот так: *

Как добавить изображение из файла

<image src="/images/picture.jpg" alt="Текст с описанием картинки">

Болонинг