Markdown-файл — это обычный текст. Если открыть его в Блокноте или редакторе кода, вместо жирного шрифта, заголовков и таблиц вы увидите звёздочки, решётки и вертикальные черты. Просмотрщик Markdown превращает этот текст в читаемую страницу — так же, как GitHub показывает README.
Markdown Preview Editor можно использовать как бесплатный просмотрщик: откройте файл в браузере, переключитесь в режим просмотра и читайте. Устанавливать ничего не нужно, аккаунт не нужен, а файл остаётся на вашем компьютере.
Что такое файл .md?
Файл с расширением .md (иногда .markdown) — это текстовый документ в разметке Markdown. # Заголовок становится заголовком, **жирный** — жирным, а несколько вертикальных черт — таблицей. Такие файлы встречаются повсюду: README на GitHub, документация, заметки из Obsidian, выгрузки из чат-ботов и баз знаний.
Открыть .md можно любым текстовым редактором, но оформление покажет только просмотрщик Markdown. Если хотите разобраться в самом синтаксисе, держите под рукой шпаргалку по Markdown.
Как открыть MD-файл онлайн
- Откройте редактор. Перейдите в онлайн-редактор — он загружается за секунду.
- Добавьте файл. Перетащите
.md-файл в область редактора или нажмите Открыть (Ctrl+O,⌘Oна Mac). Можно открыть сразу несколько файлов или целую папку — каждый документ откроется в своей вкладке. - Включите режим просмотра. Нажмите Просмотр в шапке, чтобы читать документ на всю ширину. Если хотите что-то поправить, режим разделённого экрана покажет исходный текст и результат рядом.
- При необходимости сохраните или экспортируйте. Сохраните файл как
.md, выгрузите его в самостоятельную HTML-страницу или распечатайте в PDF.
Поддерживаются файлы .md, .markdown, .mdown, .mkd, .mkdn, .mdx и .txt.
Что показывает просмотрщик
Просмотрщик понимает GitHub-Flavored Markdown, поэтому документы выглядят почти так же, как на GitHub:
- заголовки, списки, ссылки, цитаты и горизонтальные линии;
- таблицы с выравниванием столбцов и списки задач с флажками;
- блоки кода с подсветкой синтаксиса;
- сноски и блоки-предупреждения в стиле GitHub (
[!NOTE],[!TIP],[!WARNING]); - математические формулы на LaTeX;
- диаграммы Mermaid — блок-схемы, диаграммы последовательности и другие.
Ссылки между открытыми .md-файлами переключают вкладки, так что папка с документацией читается как небольшой сайт.
Картинки и ссылки
Картинки с относительными путями вроде images/diagram.png отображаются, если открыть папку целиком или перетащить картинки вместе с документом. Редактор находит их по путям среди перетащенных файлов.
Картинки, аудио и видео из интернета по умолчанию не загружаются, а ссылки неактивны, пока вы их не разрешите. Так задумано: файл из неизвестного источника не должен обращаться к чужим серверам. Внешние картинки, медиа или ссылки можно разрешить одним щелчком в панели защиты.
Файл остаётся на вашем устройстве
Многие онлайн-просмотрщики загружают файл на сервер, чтобы его отобразить. Здесь файл читает ваш браузер и отображает прямо во вкладке — никуда он не отправляется. Документы хранятся, только пока открыта вкладка, если вы не включили в настройках Запоминать документы в этом браузере.
Поэтому просмотрщик подходит для внутренней документации, черновиков, договоров и всего, что не хочется выкладывать в сеть.
Ограничения
- Это веб-страница, поэтому её нельзя назначить программой по умолчанию для
.md-файлов в Windows или macOS, чтобы открывать их двойным щелчком. Перетащите файл на страницу или нажмите Открыть. - Файлы открываются только с вашего устройства. Чтобы посмотреть Markdown-файл с GitHub или другого сайта, сначала скачайте его или вставьте его текст в редактор.
- Длинному документу с большим количеством диаграмм нужно чуть больше времени: каждая диаграмма рисуется в браузере.
Нужен редактор с живым предпросмотром рядом с текстом? Прочитайте, как смотреть Markdown онлайн с предпросмотром, или вернитесь на главную страницу Markdown-редактора.
Частые вопросы
Чем открыть файл .md?
Откройте онлайн-просмотрщик Markdown и перетащите на него .md-файл или нажмите Открыть. Переключитесь в режим Просмотр, чтобы читать текст с оформлением. Ничего устанавливать и регистрироваться не нужно.
Файл загружается на сервер?
Нет. Файл читается и отображается в вашем браузере. Он не покидает устройство и не сохраняется, если вы не включили Запоминать документы в этом браузере.
Можно ли посмотреть Markdown-файл вместе с картинками?
Да. Откройте папку целиком или перетащите картинки вместе с .md-файлом. Относительные пути к картинкам найдутся среди перетащенных файлов.
Работает ли просмотрщик на телефоне?
Да. На телефоне выберите файл кнопкой Открыть и переключитесь в режим просмотра. Интерфейс подстраивается под маленький экран.
Можно ли потом сконвертировать файл?
Да. Выгрузите его в самостоятельный HTML-файл или распечатайте в PDF — подробнее на странице Markdown в PDF.
