¶ 1. Заголовок уровня H1
Это главный заголовок документа первого уровня. Он используется для обозначения основной темы или названия всего документа. В большинстве Markdown-процессоров заголовок H1 отображается самым крупным шрифтом и часто используется для создания заголовка страницы.
Короткий абзац для проверки обычного текста.
Вторая строка через принудительный перенос (двойной пробел + Enter).
Это новый абзац. Ниже — горизонтальная линия.
¶ 2. Заголовок уровня H2
Заголовки второго уровня используются для разделения основных разделов документа. Они помогают структурировать контент и создавать логическую иерархию информации. В большинстве случаев H2 используется для главных разделов документа.
¶ 2.1 Заголовок H3
Заголовки третьего уровня применяются для подразделов внутри основных разделов. Они позволяют более детально структурировать информацию и создавать многоуровневую навигацию по документу.
¶ 2.1.1 Заголовок H4
Заголовки четвёртого уровня используются для ещё более детального разделения контента. Они помогают организовать информацию в сложных документах с множеством подтем и подразделов.
¶ 2.1.1.1 Заголовок H5
Заголовки пятого уровня применяются реже, но могут быть полезны в очень детализированных документах, где требуется глубокая иерархическая структура.
¶ 2.1.1.1.1 Заголовок H6
Заголовки шестого уровня — это самый глубокий уровень вложенности заголовков в стандартном Markdown. Они используются крайне редко и обычно применяются только в очень специфических случаях, когда требуется максимально детальная структуризация документа.
¶ 3. Форматирование текста
Markdown предоставляет множество способов форматирования текста для выделения важной информации, создания акцентов и структурирования контента. Различные стили форматирования помогают читателю быстро находить ключевую информацию и понимать структуру документа.
Обычный текст, жирный, курсив, жирный курсив.
Жирный через подчёркивания, курсив через подчёркивания.
Зачёркнутый текст.
Подстрочный и надстрочный индексы (если движок поддерживает):
H2O (формула воды) и x2 (квадрат переменной x).
Inline code внутри строки используется для обозначения команд, переменных, названий файлов или технических терминов прямо в тексте.
Экранирование спецсимволов позволяет использовать специальные символы Markdown как обычный текст: *не курсив*, #не заголовок#, `не код`.
¶ 4. Цитаты / Callouts / Admonitions
Цитаты в Markdown используются для выделения важной информации, предупреждений, подсказок и других типов уведомлений. Они помогают привлечь внимание читателя к ключевым моментам и улучшить восприятие документа.
Информация:
Это нейтральное сообщение. Используй такие блоки для заметок, справок или пояснений.
Успех:
Операция выполнена успешно. Всё прошло без ошибок, можно двигаться дальше.
Предупреждение:
Обрати внимание: тут есть потенциальный риск или важный нюанс.
Проверь данные перед тем, как продолжить.
Ошибка:
Что-то пошло не так. Проверь ввод, соединение или настройки и попробуй снова.
¶ 4.1 Вложенные цитаты
Вложенные цитаты позволяют создавать многоуровневые структуры для сложных диалогов или комментариев:
Это цитата первого уровня.
Это вложенная цитата второго уровня.
И это цитата третьего уровня.
Вернулись к первому уровню.
¶ 4.2 Цитаты с форматированием
Цитаты могут содержать различное форматирование внутри:
Это цитата с жирным текстом, курсивом и
кодом.Также можно использовать списки:
- Пункт 1
- Пункт 2
И даже таблицы:
Колонка 1 Колонка 2 Значение Данные
¶ 5. Списки
Списки — это один из самых часто используемых элементов Markdown. Они помогают структурировать информацию в виде перечислений, инструкций или иерархических структур.
¶ 5.1 Маркированный список
Маркированные списки используются для перечисления элементов без определённого порядка:
- пункт 1
- пункт 2
- подпункт 2.1
- подпункт 2.2
- подпункт 2.2.1
- пункт 3
Альтернативные маркеры (звёздочки и плюсы):
- Пункт со звёздочкой
- Ещё один пункт
- Подпункт с плюсом
- Ещё подпункт
¶ 5.2 Нумерованный список
Нумерованные списки применяются для последовательных шагов, инструкций или упорядоченных элементов:
- первый
- второй
- третий
- третий.1
- третий.2
¶ 5.3 Смешанный
Списки можно комбинировать, создавая сложные структуры:
- шаг 1
- вариант A
- вариант B
- шаг 2
- вариант C
- вариант D
- подвариант D.1
- подвариант D.2
¶ 5.4 Task list (чекбоксы)
Списки задач позволяют отмечать выполненные пункты:
- сделано
- не сделано
- ещё один пункт
- ещё одно выполненное задание
¶ 6. Ссылки
Ссылки в Markdown позволяют создавать гиперссылки на внешние ресурсы, внутренние разделы документа или email-адреса. Они являются важным элементом для создания интерактивных документов.
Обычная ссылка: OpenAI
Автоссылка: https://example.com
Email-автоссылка: test@example.com
Ссылка с подсказкой: пример
¶ 6.1 Ссылки в стиле reference
Ссылки через идентификатор удобны для повторного использования и улучшения читаемости исходного кода:
Ссылка через идентификатор: OpenAI и ещё одна Example.
¶ 6.2 Якоря (ссылки на заголовки)
Многие Markdown-процессоры поддерживают создание ссылок на заголовки внутри документа:
Ссылка на раздел "Форматирование текста"
¶ 7. Картинки
Изображения в Markdown позволяют визуализировать информацию и делают документы более наглядными. Поддерживаются различные форматы изображений и способы их вставки.
Встроенная картинка:
Картинка-ссылка:
¶ 7.1 Картинки с подсказками
Изображения могут иметь подсказки, которые отображаются при наведении:
¶ 7.2 Reference-стиль для изображений
Изображения также можно определять через reference-ссылки:
¶ 8. Код
Блоки кода в Markdown используются для отображения исходного кода, конфигурационных файлов, команд терминала и других технических данных. Поддержка подсветки синтаксиса зависит от используемого процессора.
¶ 8.1 Блочный код без подсветки
Блоки кода без указания языка отображаются как простой текст:
line 1
line 2
line 3
¶ 8.2 Блочный код с подсветкой (Python)
def hello(name: str) -> str:
return f"Привет, {name}!"
print(hello("мир"))
¶ 8.3 Примеры различных языков
JavaScript:
const greet = (name) => {
return `Привет, ${name}!`;
};
console.log(greet("мир"));
Bash:
echo "hello world"
ls -la
cd /path/to/directory
JSON:
{
"name": "Markdown Test",
"version": "1.0.0",
"description": "Тестовый документ",
"keywords": ["markdown", "test"]
}
YAML:
name: Markdown Test
version: 1.0.0
description: Тестовый документ
keywords:
- markdown
- test
SQL:
SELECT id, name, email
FROM users
WHERE status = 'active'
ORDER BY created_at DESC;
HTML:
<div class="container">
<h1>Заголовок</h1>
<p>Параграф текста</p>
</div>
CSS:
.container {
max-width: 1200px;
margin: 0 auto;
padding: 20px;
}
¶ 9. Таблицы
Таблицы в Markdown позволяют структурированно представлять данные в виде строк и столбцов. Они особенно полезны для сравнения данных, создания списков свойств или отображения результатов.
Простая таблица:
| Колонка A | Колонка B | Колонка C |
|---|---|---|
| 1 | 2 | 3 |
| foo | bar | baz |
Таблица с выравниванием:
| Left | Center | Right |
|---|---|---|
| a | b | c |
| 10 | 20 | 30 |
| длинный текст | центрированный | справа |
¶ 9.1 Сложная таблица с форматированием
Таблицы могут содержать форматированный текст внутри ячеек:
| Элемент | Описание | Статус |
|---|---|---|
| Заголовок | Обычный текст | ✅ Готово |
| Курсив | Код в ячейке |
⚠️ В процессе |
| Ссылка | ❌ Отменено |
¶ 10. Сноски (если поддерживается движком)
Сноски позволяют добавлять дополнительные комментарии или ссылки на источники без нарушения основного потока текста. Они особенно полезны в академических или технических документах.
Текст со сноской[1] и ещё одной[2]. Также можно использовать числовые сноски[3].
¶ 11. Definition list (если поддерживается)
Списки определений используются для создания словарей, глоссариев или описания терминов. Они особенно полезны в технической документации.
Markdown
: Язык разметки для создания форматированного текста с использованием простого синтаксиса.
HTML
: HyperText Markup Languageввв — стандартный язык разметки для создания веб-страниц.
CSS
: Cascading Style Sheets — язык стилей, используемый для описания внешнего вида документов.
¶ 11.1 Множественные определения
Термин может иметь несколько определений:
API
: Application Programming Interface
: Набор протоколов и инструментов для создания программного обеспечения
: Интерфейс для взаимодействия между различными компонентами системы
¶ 12. Математические формулы (если поддерживается)
Математические формулы в Markdown позволяют отображать сложные математические выражения и уравнения. Поддержка зависит от используемого процессора (например, через MathJax или KaTeX).
Inline формулы: и x = \frac{-b \pm \sqrt{b^2-4ac}}
Блочные формулы:
Более сложный пример:
¶ 13. Коллапсы / details (HTML внутри Markdown)
HTML-элементы могут быть встроены в Markdown для расширения функциональности. Элемент <details> позволяет создавать раскрывающиеся блоки контента.
Нажми, чтобы раскрыть
Внутри может быть Markdown:
- список
- ещё пункт
console.log("inside details");
И даже таблицы:
| Колонка 1 | Колонка 2 |
|---|---|
| Значение | Данные |
📚 Дополнительная информация
Этот блок содержит дополнительную информацию, которая может быть скрыта по умолчанию. Это полезно для создания FAQ, спойлеров или дополнительных деталей, которые не должны отвлекать от основного контента.
¶ 14. Вставка HTML
HTML-элементы могут быть встроены напрямую в Markdown для создания более сложных структур и стилизации, которые невозможно достичь только средствами Markdown.
¶ 14.1 Дополнительные HTML-элементы
Ctrl + C для копирования.
Выделенный текст с помощью HTML-тега.
HTML — это аббревиатура.
¶ 15. Разделители, символы, эмодзи
Разделители помогают визуально разделять разделы документа, а эмодзи и специальные символы делают текст более выразительным и наглядным.
Три звёздочки как разделитель:
Три дефиса:
Три подчёркивания:
Эмодзи: 😀 🚀 ✅ ❌ ⚠️ 📝 🔍 💡 🎯 🌟 🎉 📊 📈 📉 🔥 💻 🎨 🎭 🎪
Спецсимволы: © ® ™ → ← ↑ ↓ ↔ ⇒ ⇐ ⇑ ⇓ ∞ ≠ ≤ ≥ ± × ÷ ∑ ∏ ∫ ∂ ∇
¶ 16. Abbreviations (сокращения)
Сокращения позволяют определять аббревиатуры, которые будут автоматически расшифровываться при наведении курсора. Это особенно полезно для технических терминов и профессиональной лексики.
В тексте можно использовать HTML, CSS, API, JSON и YAML — при наведении курсора будут показываться их расшифровки.
¶ 17. Горизонтальные разделители
Горизонтальные разделители используются для визуального разделения разделов документа. В Markdown поддерживается несколько способов создания разделителей.
Три дефиса:
Три звёздочки:
Три подчёркивания:
¶ 18. Комментарии HTML
HTML-комментарии в Markdown не отображаются в финальном документе, но могут быть полезны для заметок в исходном коде.
Текст после комментария отображается нормально.
¶ 19. Комбинированные элементы
Этот раздел демонстрирует комбинации различных элементов Markdown для создания сложных структур.
¶ 19.1 Список с цитатами
-
Первый пункт с цитатой:
Это цитата внутри списка.
Она может содержать несколько строк. -
Второй пункт с кодом:
print("Код внутри списка") -
Третий пункт с таблицей:
A B 1 2
¶ 19.2 Цитата со списками
Это цитата, содержащая:
- Нумерованный список
- Ещё один пункт
И маркированный:
- Пункт A
- Пункт B
А также
коди форматирование.
¶ 20. Заключение
Этот документ демонстрирует широкий спектр возможностей Markdown для создания структурированных и форматированных документов. Markdown предоставляет простой и интуитивный синтаксис, который легко читается как в исходном виде, так и в отрендеренном формате.
Основные преимущества Markdown:
- Простота — легко изучать и использовать
- Читаемость — исходный код понятен даже без рендеринга
- Универсальность — поддерживается множеством платформ и инструментов
- Расширяемость — можно добавлять HTML и другие элементы
- Версионность — легко отслеживать изменения в системах контроля версий
Markdown идеально подходит для:
- Документации проектов
- Технических руководств
- Блогов и статей
- Заметок и записей
- README-файлов
- И многого другого
Документ создан для тестирования возможностей рендеринга Markdown в различных процессорах и вики-системах.