ФорматыЧто такое .env файл и как с ним работать
Разбираем назначение .env-файлов, синтаксис переменных окружения и типичные ошибки при работе с ними.
Скачали README.md с GitHub, экспортировали заметки из приложения или получили документацию проекта — и открыли файл обычным «Блокнотом», а вместо аккуратного текста увидели решётки, звёздочки и квадратные скобки вперемешку с текстом? Это не сломанный файл: расширение .md почти всегда означает документ с разметкой Markdown, и чтобы увидеть его в «человеческом» виде, нужна программа с предпросмотром. Разбираем, чем открыть MD-файл на компьютере и телефоне, как устроена сама разметка и как перевести MD в PDF, Word или HTML — для этого пригодится и наш конвертер PDF ⇄ Word.
Коротко: расширение .md почти всегда означает текстовый файл с разметкой Markdown — языком для структурирования текста без HTML-тегов (заголовки, списки, ссылки через простые символы). Открыть его можно обычным Блокнотом, но для нормального просмотра форматирования нужен редактор с предпросмотром (VS Code, Typora, онлайн-вьюер) или конвертация в PDF, Word либо HTML.
Markdown — это упрощённый язык разметки текста, который придумал в 2004 году американский технический писатель John Gruber. Идея была простая: позволить человеку форматировать текст (заголовки, списки, жирное и курсивное начертание, ссылки) обычными символами клавиатуры, не трогая HTML-теги, и при этом чтобы необработанный текст оставался легко читаемым сам по себе — без браузера или специальной программы.
Файл с расширением .md — это обычный текстовый файл, в котором как раз использована такая разметка. Чем он отличается от TXT и от HTML:
#, -, **, []()), которые программа-редактор умеет превращать в оформленный текст.<h1>Заголовок</h1> достаточно написать # Заголовок с решёткой впереди. При этом сам Markdown часто конвертируют в HTML — обратное тоже возможно.Именно поэтому формат стал стандартом де-факто для документации и заметок: файлы README.md на GitHub и GitLab, страницы в Obsidian и Notion, конфиги и changelog'и большинства open-source проектов, статьи в статических генераторах сайтов — всё это MD-файлы с разметкой Markdown.
У подавляющего большинства пользователей, которые ищут «чем открыть .md», речь идёт именно о Markdown-документе. Но расширение .md исторически занято и под другие, редкие сценарии: образы ROM-картриджей для эмулятора Sega Mega Drive (Genesis) и некоторые файлы 3D-моделей отдельных программ тоже иногда используют его. Отличить их просто: Markdown-файл весит считаные килобайты и открывается текстом в любом редакторе, а если файл весит мегабайты и текстовый редактор показывает нечитаемую «кашу» из символов — перед вами не Markdown, а что-то другое, и открывать его нужно профильной программой под конкретную задачу (эмулятором или 3D-редактором), а не текстовым редактором.
Способ зависит от того, нужен ли вам просто текст или оформленный документ с заголовками, списками и ссылками «как на картинке».
Любой MD-файл откроется в обычном текстовом редакторе — «Блокноте» на Windows, TextEdit на macOS, Notepad++ или любом другом. Вы увидите весь текст и символы разметки (#, *, -) как есть, но заголовки не станут крупнее, а списки не получат отступов — разметка не отрисовывается, редактор показывает её «как написано». Для быстрой проверки содержимого этого достаточно.
Чтобы увидеть документ оформленным, нужен редактор, который понимает Markdown и умеет рендерить его в читаемый вид:
Ctrl+Shift+V (на macOS Cmd+Shift+V), чтобы открыть панель предпросмотра: разметка сразу превращается в оформленный текст. Специальных расширений устанавливать не нужно — поддержка Markdown встроена в VS Code.Если нужно один раз быстро посмотреть содержимое чужого MD-файла, необязательно ничего ставить: откройте файл через онлайн-вьюер Markdown прямо в браузере — он покажет отрендеренный текст без сохранения на свой компьютер. Для разового просмотра чужой документации это быстрее, чем устанавливать редактор. Не загружайте так файлы с конфиденциальной информацией — они уходят на чужой сервер; подробнее о рисках онлайн-сервисов — в разделе безопасность файлов.
На мобильных устройствах стандартного приложения для MD-файлов нет, но ситуация решается так же, как на компьютере:
Если задача разовая — посмотреть один присланный файл — часто проще воспользоваться браузером на телефоне и тем же онлайн-вьюером, что и на компьютере, чем ставить отдельное приложение.
Базовый синтаксис Markdown сводится к нескольким символам. Он стандартизирован в спецификации CommonMark — самом распространённом диалекте языка, на который ориентируются GitHub, VS Code и большинство редакторов.
| Что написать | Что получится |
|---|---|
# Заголовок | Заголовок первого уровня (<h1>) |
## Подзаголовок | Заголовок второго уровня (<h2>), и так до шести решёток |
**жирный текст** | жирный текст |
*курсив* | курсив |
- пункт списка | маркированный список |
1. пункт списка | нумерованный список |
[текст ссылки](https://example.com) | кликабельная ссылка |
`код` | моноширинный код внутри строки |
Этого набора хватает, чтобы прочитать и понять почти любой README или заметку. Больше символов (таблицы, цитаты, блоки кода на несколько строк) добавляются по той же логике — через простые текстовые обозначения, без HTML-тегов.
Если документ нужно переслать человеку, у которого нет Markdown-редактора, или оформить как финальный файл, Markdown конвертируют в более универсальный формат.
Если под рукой нет редактора с функцией экспорта, можно воспользоваться любым онлайн-конвертером Markdown → PDF/Word/HTML — файл загружается в браузере, конвертируется на сервере и скачивается в выбранном формате. Это удобнее, когда конвертация разовая и устанавливать редактор нет смысла. Если же вам нужна не конвертация MD, а обратная задача — перевод готового документа Word в PDF или наоборот, — смотрите отдельные гайды: как конвертировать Word в PDF и как конвертировать PDF в Word, либо воспользуйтесь нашим онлайн-конвертером PDF ⇄ Word прямо в браузере.
Если вместо аккуратного документа видно символы разметки вперемешку с текстом («решётки», «звёздочки», квадратные скобки) — дело не в кодировке, а в том, что программа, которой вы открыли файл, не умеет рендерить Markdown. Это обычное поведение простого текстового редактора вроде «Блокнота»: он честно показывает содержимое файла как есть, разметка в нём не предусмотрена — нужен редактор с предпросмотром (см. раздел выше).
Отдельная история — настоящие «кракозябры», нечитаемые символы вместо кириллицы или спецсимволов. Это действительно проблема кодировки, и она не специфична для MD: встречается в любых текстовых файлах. Если у вас именно такой случай — решение описано в гайде кракозябры и кодировка текстового файла.
Да, но Word откроет его как обычный текст, без рендеринга разметки — символы # и ** останутся видны как есть. Чтобы получить оформленный документ в Word, файл нужно сначала сконвертировать из Markdown в DOCX через редактор с функцией экспорта или онлайн-конвертер.
Такие файлы .md не являются текстовыми — их нужно открывать профильной программой под конкретную задачу: ROM-образы консоли открывает соответствующий эмулятор, файлы 3D-моделей — программа, в которой они были созданы. Проверить, что перед вами не Markdown, просто: такой файл весит значительно больше нескольких килобайт и не читается как текст.
Специального штатного приложения нет ни на Android, ни на iOS, но подойдёт любой текстовый редактор или специализированное Markdown-приложение из магазина приложений. Для разового просмотра проще открыть файл через браузер в онлайн-вьюере.
Напрямую Word и Google Docs не сохраняют файлы в Markdown — нужен отдельный конвертер или редактор, который примет DOCX на входе и выдаст .md на выходе. Проще писать документ сразу в Markdown-редакторе, если он изначально предназначен для публикации как MD.
Нет. Markdown — упрощённый язык разметки, который читается человеком даже без рендеринга и конвертируется в HTML автоматически. HTML — более подробный формат разметки веб-страниц с полным набором тегов. Markdown часто используют как «черновой» формат, который затем превращают в HTML для публикации.
GitHub сам рендерит содержимое файла README.md в оформленную страницу прямо на сайте — это описано в официальном гайде GitHub по синтаксису Markdown. Если вы скачали тот же файл и открыли его обычным «Блокнотом» на своём компьютере, рендеринга не происходит — нужен редактор с поддержкой предпросмотра Markdown (см. раздел выше).
Да — через онлайн-вьюер Markdown: загружаете файл на странице сервиса, браузер показывает его в отрендеренном виде. Некоторые браузеры также открывают .md как обычный текстовый файл при прямом переходе по локальному пути, но без оформления разметки.
Если коротко: для простого просмотра MD-файла хватит любого текстового редактора, но по-настоящему удобно работать с Markdown — значит видеть его оформленным. Для этого подойдут VS Code с предпросмотром, Typora или онлайн-вьюер, а если документ нужно передать дальше в привычном виде — конвертируйте его в PDF, Word или HTML.