У цій статті
Що таке Markdown?
Markdown — це легка мова розмітки, створена Джоном Грубером у 2004 році. Вона використовує простий синтаксис на основі пунктуації для форматування звичайного тексту: заголовки через #, жирний шрифт через **, посилання через [текст](url) — що відображається у форматованому HTML. Простота зробила Markdown універсальним стандартом для документації розробників.
Markdown використовується скрізь: файли README на GitHub, відповіді на Stack Overflow, повідомлення у Slack, сторінки у Notion, сайти документації та блог-платформи. Більшість розробників щодня пишуть Markdown, не замислюючись про це.
Як працює попередній перегляд Markdown
Попередній перегляд Markdown у CheckTown відображає ваш Markdown у HTML у реальному часі під час введення.
- Відповідність CommonMark — відображає стандартний Markdown згідно зі специфікацією CommonMark
- Розширення GFM — підтримує GitHub Flavored Markdown, включно з таблицями, списками завдань та закресленням
- Підсвічування синтаксису — блоки коду підсвічуються для поширених мов програмування
Спробуйте безкоштовно — реєстрація не потрібна
Переглянути Markdown →Коли використовувати попередній перегляд Markdown
Попередній перегляд Markdown корисний у будь-якому робочому процесі написання, де потрібно перевірити відображення перед публікацією.
- Файли README — складайте та переглядайте файли README.md перед відправкою на GitHub
- Документація — пишіть та переглядайте технічну документацію перед публікацією на сайтах документації
- Записи в блозі — готуйте публікації в Markdown та переглядайте форматований результат
Часті запитання
У чому різниця між різновидами Markdown?
Оригінальна специфікація Markdown залишила багато граничних випадків невизначеними, що призвело до появи кількох несумісних реалізацій. CommonMark — це стандартизована специфікація, яка усуває неоднозначності. GitHub Flavored Markdown (GFM) розширює CommonMark таблицями, списками завдань та автопосиланнями. Більшість платформ використовують CommonMark або GFM.
Чи може Markdown містити сирий HTML?
Так, більшість процесорів Markdown дозволяють вбудовувати сирі HTML-теги безпосередньо в документи Markdown. Це корисно для розширеного форматування, яке не підтримується синтаксисом Markdown. Однак багато платформ очищають HTML з міркувань безпеки, тому сирий HTML може бути вилучений у контексті контенту, що генерується користувачами.
Як додати таблицю в Markdown?
Таблиці використовують символи вертикальної риски та дефіси: | Заголовок 1 | Заголовок 2 | у першому рядку, | --- | --- | у другому рядку для розділювача, далі рядки з даними. Вирівнювання стовпців визначається позицією двокрапки в розділювачі: :--- — ліворуч, :---: — по центру, ---: — праворуч.