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 стає діаграмою.
Посилання та зображення
[DotMD](https://getdotmd.com)

[the plan](plan.md)
[setup](#setup)
У посилання текст стоїть у квадратних дужках, а адреса в круглих. Вебадреса сама по собі теж стає посиланням. Зображення — це посилання з ! попереду; його текст описує картинку для програм екранного читання. Шляхи відраховуються від документа, а посилання може вести на інший .md-файл або на заголовок, чий якір — його текст малими літерами з пробілами, замінюваними на -.
Для довгих або повторюваних адрес винесіть їх униз і посилайтеся за коротким іменем: [guide][1], потім [1]: https://example.com/guide в окремому рядку.
Виноски, коментарі та 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. Читання безкоштовне; про редагування див. ціни.