Создайте и откройте .md файл на Macи читайте его как на GitHub.

Как открыть Markdown-файлы на Mac

Если дважды нажать .md-файл на Mac, он обычно открывается как сырой текст, полный # и **. DotMD открывает его как страницу.

1. Откройте файл или папку

   Нажмите ⌘O и выберите папку или файл либо перетащите их из Finder на окно DotMD или его значок в Dock. Папка становится вашим рабочим пространством в боковой панели, а каждый открытый файл становится вкладкой.

2. Сделайте DotMD приложением по умолчанию для .md-файлов

   Когда DotMD впервые запускается в то время, как Markdown-файлы открывает другое приложение, он спрашивает Set DotMD as Default? Выберите Set as Default. Это можно сделать и позже в Settings → General → Default App или в Finder: выберите .md-файл, нажмите ⌘I, выберите DotMD в Открывать в приложении и нажмите Настроить….

3. Читайте

   Страница показана в готовом виде, как на GitHub. Выделяйте и копируйте текст, как на любой веб-странице, а ⌘F ищет текст на странице.

Боковая панель показывает добавленные вами папки и Markdown-файлы, а под открытым файлом его оглавление. Pinned держит вверху часто используемые файлы, а Recent перечисляет последние двадцать открытых. Ничего не копируется и не перемещается: DotMD читает ваши файлы там, где они лежат.

Как создать .md-файл на Mac

Файл .md — это обычный текстовый файл, имя которого заканчивается на .md. Без сторонних программ: откройте TextEdit, нажмите ⇧⌘T, чтобы перейти в режим простого текста, напишите текст и сохраните как notes.md. Если macOS добавит к имени .txt, переименуйте файл в Finder.

В DotMD нажмите ⌘N или выберите + → New Empty File, задайте имя и папку — новый файл откроется в редакторе с заголовком # Title (редактирование входит в DotMD Editor). + → New File from Clipboard превращает скопированный текст, например ответ агента, в файл.

Что отображается: таблицы, код, диаграммы Mermaid и формулы

• Текст: заголовки, списки, списки задач, цитаты, ссылки и изображения.
• Таблицы и код с подсветкой синтаксиса.
• Диаграммы Mermaid. Блок кода с пометкой mermaid рисуется как диаграмма в светлой или тёмной теме, в тон странице. Нажмите на диаграмму, чтобы увидеть её крупно, а щипком можно увеличить её до 8×.
• Формулы KaTeX. $E = mc^2$ внутри строки или $$ … $$ на отдельной строке.
• Врезки вроде > [!NOTE], сворачиваемые разделы и блок свойств в начале файла, показанный карточкой.

Диаграммы и формулы рисуются на вашем Mac, поэтому работают без интернета.

Читайте README.md из любого репозитория

README — это Markdown-файл, поэтому он открывается как любой другой. Нажмите ⌘O и выберите README.md или папку репозитория, чтобы прочесть и его документацию. Заголовки, таблицы, код, списки задач и диаграммы Mermaid отрисовываются, формулы тоже, а значки и другие изображения из интернета показываются. Чтение бесплатно.

Читайте с удобством

Меню Aa задаёт шрифт (System, Serif или Monospaced), ширину, межстрочный интервал и тему: Automatic, Light, Sepia или Dark. Для длинных текстов попробуйте Serif, Narrow, Relaxed и Sepia. Выбор запоминается.

⌘= и ⌘- увеличивают и уменьшают масштаб шагами по 10 %. Тонкая синяя линия вверху и процент в строке состояния показывают, сколько вы прочитали, а оглавление в боковой панели переходит к любому заголовку. Ссылка на другой .md-файл открывает его в DotMD.

Quick Look в Finder

Выберите .md-файл в Finder и нажмите пробел. Просмотр выглядит как режим чтения DotMD, с таблицами, врезками, диаграммами и формулами. Он начинает работать после первого запуска DotMD.

Quick Look может читать только сам файл, поэтому изображения, лежащие рядом, показываются маленькой заглушкой; нажмите Open with DotMD, чтобы увидеть страницу целиком. Если показывается просмотр другого приложения, проверьте, что DotMD включён в Системные настройки → Основные → Объекты входа и расширения (macOS 15 и новее) или Системные настройки → Конфиденциальность и безопасность → Расширения → Быстрый просмотр (macOS 14).

DotMD открывает файлы с расширениями .md, .markdown, .mdown, .mkd, .mkdn, .mdx и .txt.

Вопросы о чтении Markdown на Mac

Другие вопросы