Откройте эту страницу и передайте файл в окно просмотра любым удобным способом — документ отобразится, как только появится текст:

1. Перетащите файл .md в любое место панели просмотра или нажмите Открыть файл .md и выберите его.
2. Вставьте текст markdown в редактор.
3. Загрузите по ссылке — вставьте ссылку на файл на GitHub или любой прямой адрес файла и нажмите Загрузить по ссылке.

Затем нажмите Скрыть исходник, чтобы читать документ на всю ширину, выберите размер шрифта и ширину колонки, а по оглавлению переходите между заголовками. Ничего не нужно устанавливать, регистрация не требуется, и всё работает одинаково в Windows, macOS, Linux и на Chromebook. Файл читается браузером локально и не отправляется на сервер.

Файл .md — это обычный текст, поэтому Windows откроет его в Блокноте: щёлкните по файлу правой кнопкой, выберите Открыть с помощью и укажите Блокнот. Но так вы увидите исходную разметку, а не оформленный документ. Чтобы прочитать файл в нормальном виде, откройте эту страницу в браузере и перетащите файл из Проводника на панель просмотра — заголовки, таблицы и код сразу примут привычный вид.

Если у вас установлен VS Code, откройте в нём файл и нажмите Ctrl+Shift+V — встроенный предпросмотр покажет оформленный документ. Подробности есть в документации VS Code по Markdown. Файлы с расширениями .markdown, .mdx и .txt открываются точно так же.

Если Windows при двойном щелчке спрашивает, чем открыть файл, выберите Блокнот или VS Code и отметьте вариант «всегда использовать это приложение» — тогда файлы .md будут открываться без лишних вопросов. Для чтения оформленного текста всё равно удобнее браузер или предпросмотр в редакторе.

На Mac файл .md откроется в TextEdit или любом другом текстовом редакторе, но тоже в виде исходного текста с символами #, * и |. Самый быстрый способ увидеть оформление — перетащить файл из Finder в окно просмотра на этой странице в Safari, Chrome или Firefox. В VS Code для Mac предпросмотр открывается сочетанием Cmd+Shift+V.

Чтобы файлы .md всегда открывались в нужной программе, выделите файл в Finder, нажмите Cmd+I, в разделе «Открывать в программе» выберите редактор и нажмите «Изменить всё…». Удобнее всего держать открытой вкладку с этой страницей: перетащили файл — и читаете.

На телефоне отдельное приложение не нужно. Сначала сохраните файл на устройство — например, если его прислали в мессенджере или по почте. Затем откройте эту страницу в браузере и нажмите Открыть файл .md:

• Android: в окне выбора файлов найдите документ в «Загрузках» или в приложении «Файлы».
• iPhone и iPad: в Safari выберите пункт «Выбрать файлы» и найдите документ в приложении «Файлы» или в iCloud Drive.

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

Потому что markdown — это текст с разметкой, а не готовый документ, как в Word. Символы # обозначают заголовки, ** — жирный текст, | — столбцы таблицы, а тройные обратные кавычки — блоки кода. Текстовый редактор показывает эти символы как есть, а программа просмотра markdown превращает их в оформление. README, открытый в Блокноте, выглядит как сплошная стена из #, | и кавычек; тот же файл здесь — это заголовки, таблицы и подсвеченный код с кликабельным оглавлением.

Читать так быстрее, и заодно можно проверить, что документ отображается как задумано, ещё до коммита: незакрытый блок кода или сломанная таблица сразу бросаются в глаза. Если по ходу чтения возникают вопросы по синтаксису, держите под рукой шпаргалку по Markdown.

Для разового файла быстрее всего онлайн-просмотрщик вроде этого: ничего не нужно устанавливать, а документ отображается по правилам GitHub, поэтому README выглядит так же, как будет выглядеть на GitHub. Если вы работаете с markdown каждый день, удобнее редактор с живым предпросмотром:

• VS Code — встроенный предпросмотр, Ctrl+Shift+V (на Mac Cmd+Shift+V).
• Obsidian — заметки в markdown с режимом чтения.
• Typora — редактор, который сразу показывает оформленный текст.

GitHub и GitLab тоже показывают файлы .md с оформлением прямо в веб-интерфейсе репозитория. Чтобы прочитать README и папку docs целого репозитория с работающими ссылками между файлами, используйте просмотр README с GitHub.

Нажмите Поделиться ссылкой. Документ будет опубликован по короткому адресу и откроется в том же виде, что и здесь, вместе с диаграммами; ссылка действует 30 дней. Ссылка публичная: документ увидит любой, у кого она есть, поэтому не публикуйте так конфиденциальные данные. Получателю не нужно ничего устанавливать — он просто открывает веб-страницу.

Другие сроки хранения, токены для редактирования, raw-адреса и MCP-сервер для публикации прямо из Cursor или Claude Code доступны на главной странице Docs MD. Если нужен файл, а не ссылка, нажмите Печать / PDF и выберите «Сохранить как PDF» в окне печати браузера — или воспользуйтесь отдельным конвертером Markdown в PDF.

GitHub Flavored Markdown (GFM): CommonMark плюс таблицы, списки задач, зачёркивание, автоссылки и сноски, а также подсветка синтаксиса в блоках кода. Так же markdown отображают GitHub, GitLab и большинство сайтов документации, поэтому здесь вы видите README именно таким, каким он будет после пуша. Блоки кода с пометкой mermaid превращаются в диаграммы. В мессенджерах — Discord, Slack, Telegram — свои диалекты разметки, и там тот же текст может выглядеть иначе. Если вы готовите документ для GitHub, проверяйте его здесь; если для чата — сверяйтесь с правилами конкретного приложения.