Markdown: удобный формат для документации, заметок и README

Markdown удобен тем, что даёт минималистичный, быстрый и предсказуемый способ форматировать текст, не отвлекаясь на визуальные панели, кнопки и сложные разметки.

Ты пишешь текст — сразу получаешь читаемую структуру:

# — заголовок
**...** — жирный
- — список
`...` — код

Не нужно мышкой кликать по кнопкам или возиться с WYSIWYG-редакторами.

Markdown открывается и одинаково читается:

• в GitHub/GitLab
• в IDE (VS Code, JetBrains)
• в блогах, CMS, документации
• в Telegram, Discord, Jira, Notion (частично)
• в DevOps-скриптах и README

Текст не привязан к платформе, как, например, Word или HTML.

Маркированные списки, таблицы, ссылки, кодовые блоки — всё делается проще и быстрее. Для DevOps особенно удобно: документация к скриптам, README к репо, инструкции.

Markdown не засорён служебной разметкой как HTML. Даже в исходном виде текст остаётся читаемым.

Читайте также: Хостинг для HTML сайта и Static HTML: ТОП вариантов (бесплатно и VPS), Как сделать сайт на GitHub Pages: простая инструкция, Hugo для статических сайтов: установка и примеры.

Основные правила можно выучить за 10 минут. Большинство пользователей осваивают 80% возможностей в первый же день.

# H1
## H2
### H3
#### H4

В Markdown обычная ссылка делается так: сначала в квадратных скобках пишется текст ссылки, а сразу после них в круглых скобках — URL

[текст ссылки](https://адрес-сайта.com)

Пример в тексте

Каждый новичок в арбитраже трафика, крипте или e-commerce начинает свой путь с одного и того же вопроса: «Зачем платить $100 в месяц, если можно найти [бесплатный антидетект](https://dieg.info/articles/luchshie-antidetekt-brauzery-dlya-raboty/)?».

Чистый Markdown не поддерживает атрибут target="_blank" — он просто генерирует обычный <a href="…"> без дополнительных атрибутов. То есть для надёжного открытия в новом окне используй HTML-тег <a> прямо в тексте Markdown, например:

<a href="https://dieg.info/articles/luchshie-antidetekt-brauzery-dlya-raboty/" target="_blank" rel="noopener nofollow">бесплатный антидетект</a>

В современных версиях Hugo (Goldmark) можно добавлять атрибуты прямо к ссылке, если в hugo.toml включена опция attributes.

[бесплатный антидетект](https://dieg.info/articles/luchshie-antidetekt-brauzery-dlya-raboty/){target="_blank" rel="nofollow"}

Так как мы заботимся о SEO, обязательно добавь описание в квадратные скобки (Alt-текст).

![ALT текст для изображения](/images/articles/vpn-compatibility.webp)