Как открыть и поправить присланный .md файл
Вам прислали файл с расширением .md и попросили что-то в нём исправить. Открывать его в Блокноте неудобно: вокруг слов решётки, звёздочки и вертикальные черты, и непонятно, что из этого можно трогать. В редакторе на этом сайте файл выглядит как обычный документ.
- Нажмите «Открыть» и выберите файл. Можно просто перетащить его в окно.
- Правьте текст как в Word: кнопки сверху делают заголовки, жирный, списки, ссылки и таблицы. Таблица остаётся таблицей, в ячейку можно кликнуть и писать.
- Нажмите «Сохранить» и отправьте файл обратно.
Документ нужен с нуля? Кнопка «Новый» очистит страницу, дальше пишите как в обычном редакторе, а «Сохранить» отдаст готовый .md.
Регистрироваться не нужно, устанавливать тоже. Редактор бесплатный.
Что такое Markdown
Markdown это способ оформлять текст обычными символами. Решётка в начале строки делает заголовок, две звёздочки вокруг слова делают его жирным, дефис в начале строки превращает её в пункт списка. Файл при этом остаётся простым текстом, его откроет любая программа на любом компьютере, а в Git видно, какое именно слово поменяли.
Поэтому в Markdown пишут документацию к программам, README на GitHub, технические задания, заметки в Obsidian и Notion. Программисту такой файл читать удобно. Человеку, который разметку видит впервые, нет: он боится стереть лишнюю звёздочку и сломать документ.
В визуальном режиме этого редактора разметки не видно. Она появляется только в том месте, где стоит курсор, и только если её нужно поправить. Кому удобнее с исходником, есть режимы «Код» и «Два окна».
Чем открыть .md файл
На компьютере .md открывается любым текстовым редактором: Блокнотом в Windows, TextEdit на Mac. Но там вы увидите разметку как есть. Чтобы видеть документ, откройте файл в редакторе, прямо в браузере.
На телефоне сложнее. iPhone и Android показывают .md как голый текст или не показывают вовсе. Откройте md.vv-dev.ru в браузере телефона, нажмите «Открыть» и выберите файл из «Файлов», Загрузок или вложения мессенджера.
Как сохранить и вернуть файл
Что происходит по кнопке «Сохранить», зависит от браузера.
Chrome, Edge и Яндекс Браузер на компьютере записывают правки прямо в тот файл, который вы открыли. Браузер один раз спросит разрешение.
Safari и Firefox так не умеют. Они кладут исправленный файл в папку «Загрузки» под тем же именем, что у исходного. Его и отправляйте.
На iPhone и Android есть кнопка «Поделиться»: файл сразу уходит в Telegram, почту или «Файлы». Для телефона это самый короткий путь вернуть документ отправителю.
В любом браузере имя файла остаётся прежним. Там, где вы ничего не правили, файл совпадает с исходным до байта: редактор не переписывает чужую разметку, отступы и переводы строк.
Шпаргалка по разметке
Если хочется писать разметку руками или понять, что видно в режиме «Код»:
| Пишется | Получится |
|---|---|
# Заголовок | заголовок первого уровня, ## и ### мельче |
**жирный** | жирный |
*курсив* | курсив |
~~зачёркнутый~~ | зачёркнутый |
- пункт | пункт маркированного списка |
1. пункт | пункт нумерованного списка |
- [ ] задача | строка с галочкой |
[текст](https://адрес) | ссылка |
 | картинка |
> цитата | цитата |
`код` | код внутри строки |
| A | B | | строка таблицы |
Пустая строка между абзацами обязательна. Без неё две строки склеятся в одну.
Почему файл не уходит на сервер
Весь редактор работает в вашем браузере. Файл читается с вашего диска и записывается туда же, на сервер не отправляется ни текст, ни имя файла. В присланных документах бывают чужие телефоны, адреса и суммы договоров, и незачем, чтобы они проходили через чей-то сервер.
Сайт считает только посещения и действия: открыли файл, начали править, сохранили, переключили режим, открыли справку, случилась ошибка. Без куки, без имени файла, без текста и без IP-адреса. Если в браузере включён запрет отслеживания или в справке стоит галочка «Не считать мои посещения», не считает и этого.
Пока файл не сохранён, редактор держит черновик в памяти браузера. Закрыли вкладку случайно, открыли сайт снова, и он предложит восстановить правки. После сохранения черновик стирается. Учтите это на чужом компьютере: несохранённый черновик увидит следующий, кто откроет сайт в этом браузере.
Картинку по ссылке из интернета браузер загружает с её сайта, и тот сайт видит ваш адрес. Адрес нашей страницы ему не передаётся.
После первого захода редактор работает и без интернета. В Chrome на компьютере его можно установить как приложение.
Частые вопросы
Вместо картинки рамка с именем файла
Картинка в документе записана ссылкой на соседний файл, например img/shema.png. Браузер видит только сам .md, соседних файлов у него нет, поэтому редактор рисует рамку с путём. Ссылка в тексте при этом не меняется: у отправителя картинка останется на месте.
Можно вставить скриншот?
Да, из буфера обмена. Редактор уменьшит его и встроит прямо в файл, так что документ останется одним файлом. GitHub такие встроенные картинки не показывает, если файл потом пойдёт туда, лучше приложить картинку отдельно.
Файл был в старой кодировке Windows-1251
Редактор его прочитает и предупредит, что сохранит в UTF-8. Кириллица откроется у всех, но байты файла будут другими.
Можно открыть несколько файлов сразу?
Нет, один документ в одной вкладке. Нужен второй, откройте сайт в соседней вкладке.
Я что-то испортил
⌘Z на Mac или Ctrl+Z в Windows отменяет последние правки по одной. Пока вы не нажали «Сохранить», исходный файл на диске не тронут.