Markdown на одній сторінці.Що ви пишете і що отримуєте.

Markdown — це простий текст з кількома знаками, що означають форматування. На цій сторінці перелічено ті, що вам стануть у пригоді, з тим, що ви вводите й що отримуєте.

macOS 14 або новіша. Читати можна безкоштовно; редагування й рев'ю оплачуються один раз.

Коротко

Markdown — це простий текст з кількома знаками: # для заголовків, - для списків, **bold**, `code`, [link](url), | a | b | для таблиць, - [ ] для завдань. На сторінці перелічено всі елементи з тим, що ви вводите й що отримуєте, зокрема розширення GitHub: таблиці, списки завдань, виноски, діаграми Mermaid та формули.

Заголовки, текст і переноси рядків

Ви вводитеВи отримуєте
# Heading 1 до ###### Heading 6Заголовки від найбільшого до найменшого. Після # ставте пробіл.
**bold**жирний
*italic* або _italic_курсив
~~strikethrough~~закреслений
> a quoteЦитата з відступом. Цитати можна вкладати одну в одну через > >.
--- в окремому рядкуГоризонтальна лінія. Залиште над нею порожній рядок.
\*not italic\*Зворотна скісна риска показує символ як є.

Порожній рядок починає новий абзац. Одинарний перенос рядка всередині абзацу ігнорується, і рядки склеюються. Щоб примусово перенести, закінчіть рядок двома пробілами або зворотною скісною рискою.

Списки, списки завдань і таблиці

- Milk
- Bread
  - Rye
  - Wheat

1. Open the folder
2. Pick a file

- [x] Write the plan
- [ ] Review it

Маркований список починає кожен рядок із -, * або +. Для вкладеності зробіть відступ у два чи чотири пробіли. У нумерованому списку правильним має бути лише перший номер. Список завдань — це маркований список із [ ] або [x] на початку, він показується прапорцями.

| Plan  | Price | Users |
|-------|------:|:-----:|
| Free  |    $0 |   1   |
| Team  |   $12 |  10   |

У таблиці другий рядок відокремлює заголовок від рядків. :--- вирівнює стовпець ліворуч, ---: праворуч, а :---: по центру. Стовпці в тексті не мусять стояти рівно. Щоб поставити | всередині клітинки, напишіть \|.

Код

Код у рядку беріть в одинарні зворотні лапки. Для блока поставте три зворотні лапки в рядку до і в рядку після, а після відкривних напишіть мову, щоб отримати підсвічування синтаксису:

```swift
let greeting = "Hello"
```

Блок із позначкою diff підсвічує рядки, що починаються з + і -. Блок із позначкою mermaid стає діаграмою.

Виноски, коментарі та front matter

> [!NOTE]
> Useful information that users should know.

Цитата, перший рядок якої — [!NOTE], [!TIP], [!IMPORTANT], [!WARNING] або [!CAUTION], стає кольоровим блоком, із тим самим синтаксисом, що й на GitHub.

  • Коментарі, які не видно на сторінці: <!-- a note only visible in the text -->.
  • Розділи, що згортаються, через HTML-теги <details> і <summary>, з порожніми рядками навколо Markdown усередині.
  • Front matter: блок між двома рядками --- на самому початку файлу, з назвою, тегами чи статусом. DotMD показує його карткою Properties над документом.

Формули та діаграми

Два розширення, які малюють і GitHub, і DotMD. Формула стоїть між знаками долара, $E = mc^2$, або між подвійними в окремому рядку: формули в Markdown на LaTeX. Діаграма — це блок коду з позначкою mermaid і текстом усередині: діаграми Mermaid.

Спробуйте

Найшвидше вивчити знаки, побачивши їх відмальованими. Відкрийте будь-який .md-файл у DotMD і читайте його відформатованим, із таблицями, кодом, виносками, діаграмами та формулами. Читання безкоштовне. У редакторі символи за вас вводить меню Insert, тож нічого з цього пам’ятати не треба.

Запитання про синтаксис Markdown

Чим Markdown відрізняється від GitHub Flavored Markdown?

GitHub Flavored Markdown додає до базового синтаксису таблиці, списки завдань, закреслення й автопосилання.

Як зробити перенос рядка?

Закінчіть рядок двома пробілами або зворотною скісною рискою чи залиште порожній рядок для нового абзацу.

Як написати коментар, який не видно?

Напишіть <!-- like this -->. На сторінці він прихований і видимий лише в тексті.

Як побачити свій Markdown відмальованим?

Відкрийте будь-який .md-файл у DotMD. Читання безкоштовне; про редагування див. ціни.

Інші запитання