Синтаксис Markdown — облегчённый язык разметки

toxu

(Официальный аккаунт) #1

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

Любая разметка синтаксиса Markdown, есть в редакторе. Однако в случае копирования материала с других сайтов, автоматически будут переноситься сюда и теги.

Возможно придется убирать лишние теги или добавлять свои.


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

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

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

# Заголовок первого уровня
## Заголовок 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. Тут собственно тот текст, который нужен.
  1. элемент 1
  2. элемент 2
    1. вложенный
    2. вложенный
  3. элемент 3
  4. Тут собственно тот текст, который нужен.

Цитаты

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

> Каждый живет, как хочет, и расплачивается за это сам.
> (c) Оскар Уайльд

Каждый живет, как хочет, и расплачивается за это сам.
© Оскар Уайльд


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

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

***


Ссылки

Это встроенная [ссылка с title элементом](https://toxu.ru/help "Раздел помощи"). Это — [без title](https://toxu.ru/help).

Это встроенная ссылка с title элементом. Это — без title.

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


Выделение

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

Например, это _italic_ и это тоже *italic*. А вот так уже __strong__, и так тоже **strong**. А так ***жирный и наклонный*** одновременно.

Например, это italic и это тоже italic. А вот так уже strong, и так тоже strong. А так жирный и наклонный одновременно.


Картинки

![150x100|150x100](upload://w7gCRadbHZ932Idn1unXSUtkWC8.png)

150x100

Уменьшение или увеличение картинок:

![150x100|150x100,50%](upload://w7gCRadbHZ932Idn1unXSUtkWC8.png)

150x100


Таблицы

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

| 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

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


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

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

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

Выделять слова можно при помощи * и _ . Например, это italic и это тоже italic. А вот так уже strong, и так тоже strong.


Из правил:

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

Последняя редакция 6 декабря 2017 года