Форматування Markdown

Markdown це популярна легка мова розмітки, що використовується для додавання елементів форматування до текстових повідомлень на Eolymp, таких як коментарі, пости, тощо.

Markdown використовує спеціальний синтаксис, щоб позначити, які слова та фрази повинні мати інший вигляд. Наприклад, щоб позначити фразу жирним, ви можете додати дві зірочки до і після неї: **цей текст жирний**.

Парсер Markdown, який використовується на Eolymp, відповідає Commonmark specification, але також пропонує кілька розширень, таких як зауваження, вкладки, таблиці та огороджені блоки.

Базовий синтаксис

Абзаци

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

Заголовок

Ви можете визначити заголовок, додавши # на початку рядка. Кількість символів # визначає рівень заголовка.

Акценти

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

Посилання

Ви можете вставляти посилання за допомогою такого синтаксису [текст посилання](адреса посилання).

Зображення

Ви можете вставляти зображення, використовуючи синтаксис, подібний до посилань, але з додатковим знаком оклику ![опис зображення](адреса зображення).

Ви можете просто перетягнути зображення в поле вводу, щоб система завантажила зображення на сервер Eolymp і додала необхідну розмітку у повідомлення.

Відео

Ви можете вставляти відеофайли або відео з YouTube, використовуючи той самий синтаксис, що і для зображень.

Фрагменти коду

Інколи вам може знадобитися додати ім’я змінної чи функції, для цього використовуйте символ перевернутого апострофа `, щоб виділити фрагмент моноширинним шрифтом та спеціальним стилем. Наприклад,

Ви також можете вставляти більші фрагменти коду у свої повідомлення, використовуючи послідовність із трьох символів перевернутого апострофа ```.

Математика і формули

Якщо ви хочете додати до свого повідомлення математичний вираз або формулу, ви можете скористатися математичним режимом. Подібно до фрагментів коду, ви можете використовувати вбудовані математичні вирази, позначені одним символом $, або вставляти більші математичні блоки, обернувши їх у пару послідовностей $$.

Самі вирази записуються у математичному форматі LaTeX і відображаються за допомогою бібліотеки KaTeX. Дізнайтеся більше про вирази, які підтримує KaTeX, на їхньому веб-сайті.

Або вставляйте математичні блоки за допомогою пари послідовностей $$.

Цитати

Додайте > в початок рядка, щоб позначити фрагмент як цитату.

Розширений синтаксис

У деяких, більших документах, наприклад у дописах та на сторінках ви можете використовувати розширений синтаксис.

Таблиці

Використовуйте такий синтаксис, щоб додати таблицю.

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

• ---- стовпець використовує вирівнювання за замовчуванням

• :--- стовпець вирівнюється по лівому краю

• :--: стовпець вирівнюється по центру

• ---: стовпець вирівнюється по правому краю

Додатково, ви можете обгорнути таблицю в ::: {.center}, щоб вирівняти її по центру, або в ::: {#flex}, щоб розтягнути її на всю ширину сторінки.

Виноски

Виноски дозволяють акцентувати фрагмент документу або розмістити додаткову інформацію. Для того, щоб додати виноску використовуйте такий синтаксис

!!! note "Заголовок"
    Зміст

В цьому прикладі, note це тип виноски, а "Заголовок" це заголовок. У виносці буде відображено весь текст після цього синтаксису, розділений 4 пробілами.

Вкладки

Додайте вкладки, щоб компактно відобразити кілька варіантів одного й того ж вмісту.

Макет

Ви можете поєднувати та відображати вміст у макетах з сіткою, рядками та колонками. Також ви можете комбінувати різні макети, щоб досягти більш складних розташувань. Існує три основні типи макетів:

• column - макет розміщує елементи в одній колонці з невеликим проміжком між ними

• row - макет розміщує елементи в одному рядку з невеликим проміжком між ними

• grid - макет розміщує елементи у сітці з 2, 4 або 6 колонками

Ви можете використовувати будь-які елементи всередині блоку макета, але макети найкраще працюють з елементами div та card

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

Блоки компонування

Блоки компонування дозволяють розмістити зміст документу у декілька колонок або вирівняти елементи у певним чином. Щоб описати блок компонування використовуйте такий синтаксис.

Вирівнювання тексту

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

Віджети

Ви можете розмістити список задач, змагань чи іншу інформацію використовуючи віджети. Віджети доступні лише на сторінках сайту.