Руководство по Markdown

Вступление

Что такое Markdown?
Markdown - это облегченный язык разметки с синтаксисом форматирования обычного текста, предназначенный для веб-авторов. Он дает возможность вам легко оформлять текст без необходимости или помощи внешних инструментов или пользовательского интерфейса, который позже будет отформатирован как HTML с сохранением удобочитаемости. Markdown можно использовать вместо текста, отформатированного с помощью BBCode, или в сочетании с ним.
Вернуться к началу

Форматирование текста

Сделать текст жирным
Чтобы сделать текст жирным, заключите его в ** или __, например:
**Привет**
или
__Привет__
станет

Привет
Вернуться к началу
Сделать текст курсивным
Чтобы сделать текст курсивным, заключите его в * или _, например:
*Здорово!*
или
_Здорово!_
и вы получите

Здорово!
Вернуться к началу
Сделать текст зачеркнутым
Чтобы сделать текст зачеркнутым, заключите его в ~~, например:
~~Доброе утро!~~
и вы получите

Доброе утро!
Вернуться к началу
Сделать текст подстрочным
Чтобы сделать текст подстрочным, заключите его в ~, например:
H~2~O
и вы получите

H2O
Вернуться к началу
Сделать текст надстрочным
Чтобы сделать текст надстрочным, добавьте ^ перед текстом, например:
2^n
и вы получите

2n
Вернуться к началу
Создание заголовков
Чтобы создать заголовок, добавьте от 1 до 6 знаков # после которого, через пробел, последует текст. Чем большее число знаков, тем меньше будет текст, например:
# H1
## H2
### H3
#### H4
##### H5
###### H6
и вы получите

H1

H2

H3

H4

H5
H6
Вернуться к началу

Цитирование и вывод текста фиксированной ширины

Цитирование текста в ответах
Чтобы процитировать текст, добавьте > и необязательно пробел перед текстовой строкой, например:
> Цитированный текст
и вы получите

Цитированный текст

Вернуться к началу
Вывод кода
Чтобы вывести код, заключите его в пару ``` или ~~~, или, в качестве альтернативы, добавьте 4 пустых пробела перед каждой строкой. Вы также можете указать язык в первом маркере, например
```ruby
puts "Hello #{user}!"
```
и вы получите
puts "Hello #{user}!"
Вернуться к началу
Вывод встроенного кода
Чтобы вывести встроенный код, заключите его в пару ` или ``, например:
`<div>` тэг
или
``<div>`` тэг
и вы получите

<div> тэг
Вернуться к началу

Оформление таблиц

Создание таблиц
Чтобы создать таблицы, добавьте строку текста, разделенную | которые будут заголовками таблицы, после чего с новой строки с - и необязательно : слева, с обеих сторон или справа для выравнивания текста в столбце, разделенную знаком |. Последующие строки начните со знака | для формирования строк таблицы, например:
| Слева | По центру | Справа |
|:-----|:------:|------:|
| x | x | x |
или
Слева|По центру|Справа
:-|:-:|-:
x|x|x
и вы получите

СлеваПо центруСправа
xxx
Вернуться к началу

Создание спойлеров

Создание блочного спойлера
Чтобы создать блочный спойлер, добавьте >! и необязательно пробел перед текстовой строкой. Последующие строки могут быть начаты с >, например:
>! Скрытый текст
> Другая строка
и вы получите

Скрытый текст
Другая линия

Вернуться к началу
Создание встроенных спойлеров
Чтобы создать встроенный спойлер, заключите текст внутри >! и !< или внутри пары ||, например:
Это Reddit-style >!скрытый текст!<.
Это Discord-style ||скрытый текст||.
и вы получите

Это Reddit-style скрытый текст.
Это Discord-style скрытый текст.

Вернуться к началу

Создание списков

Создание маркированного списка
Для создания маркированного списка, добавьте *, - или + за которым следует пробел перед каждым элементом списка. Списки можно вложить, добавив 4 дополнительных пробела или табуляцию для создания подуровня, например:
- Элемент
- Подэлемент
- Элемент
и вы получите

  • Элемент
    • Подэлемент
  • Элемент
Вернуться к началу
Создание нумерованного списка
Чтобы создать упорядоченный список, добавьте цифру, за которой следуют точка и пробел, например:
1. Элемент
1. Подэлемент
2. Элемент
и вы получите

  1. Элемент
    1. Подэлемент
  2. Элемент
Вернуться к началу
Создание списка задач
Для создания списка задач, добавьте *, - или + за которым следует пробел, после [x] или [ ], и еще один пробел перед каждым элементом списка. [x] и [ ] будут отображать отмеченный или неотмеченный пункты соответственно, например:
- [x] Элемент
- [x] Подэлемент
- [ ] Элемент
и вы получите

  • Элемент
    • Подэлемент
  • Элемент
Вернуться к началу

Создание ссылок

Ссылка на другой ресурс
Чтобы создать ссылки, добавьте текст ссылки в квадратных скобках, за которым следует URL-адрес ссылки в круглых скобках, например:
[Текст ссылки](http://veloykt.ru)
и вы получите

Текст ссылки
Вернуться к началу

Показ изображений

Добавление изображений
Чтобы показать изображение, добавьте восклицательный знак, за которым следует альтернативный текст изображения в квадратных скобках, а затем URL-адрес изображения в круглых скобках, например
![Логотип велофорума](http://veloykt.ru/styles/prolight/theme/images/site_logo.png)
и вы получите

Логотип велофорума
Вернуться к началу

Дополнительно

Создание горизонтальных линий-разделителей
Чтобы создать горизонтальную линию-разделитель, добавьте по крайней мере 3 знака *, - или _ необязательно разделенные пробелом, например
***
* * *
---
- - -
___
_ _ _
и вы получите такую линию


Вернуться к началу