showmd

showmd: Самый читаемый способ просмотра Markdown на macOS

Markdown никогда не предназначался для чтения в виде простого текста. Когда вы нажимаете пробел в Finder на файле .md, стандартный Quick Look в macOS выдает кашу из решеток, звездочек и тире. showmd — это решение проблемы, превращающее сырой код в красиво оформленный документ за доли секунды.

Что такое showmd?

showmd — это легкое, быстрое и полностью бесплатное приложение для macOS, предназначенное для рендеринга Markdown-файлов. Это не редактор и не приложение для заметок, а специализированный просмотрщик, который интегрируется в систему и позволяет мгновенно видеть финальный вид документа. Программа создана для тех, кто активно работает с документацией, кодом и AI-инструментами, предоставляя наиболее чистый и функциональный интерфейс для чтения .md файлов.

Инструмент является проектом с открытым исходным кодом, гарантирует приватность (никаких облаков и телеметрии) и поддерживает все современные расширения Markdown, включая те, которые игнорируются другими просмотрщиками.

Основные возможности showmd

Приложение showmd предлагает набор функций, уникальных для экосистемы macOS:

• Мгновенное открытие: Установите приложение как стандарт для .md файлов и используйте Spacebar для предпросмотра в Finder без задержек.
• Полная поддержка GitHub Flavored Markdown (GFM): Таблицы, списки задач, зачеркивание, автоссылки и сноски отображаются корректно.
• Рендеринг YAML Frontmatter: Метаданные парсятся в аккуратную таблицу, которая по умолчанию свернута, чтобы не мешать чтению.
• Подсветка синтаксиса: Встроенная поддержка более 190 языков программирования в блоках кода.
• Математика и диаграммы: Визуализация формул LaTeX через KaTeX и отрисовка диаграмм Mermaid прямо в окне просмотра.
• Стилизация для AI-агентов: Уникальная функция обработки XML-тегов (таких как <instructions>, <thinking>, <example>), которые преобразуются в стильные блоки с границами.
• Нативная эстетика: Поддержка темной темы, системных шрифтов и горячих клавиш macOS.
• Переключение режимов: Возможность в один клик переключиться между отрендеренным видом и исходным кодом, а также функция «Copy as HTML».

Как использовать showmd

Настройка showmd занимает меньше минуты и не требует сложной конфигурации:

1. Загрузка и установка: Вы можете скачать подписанный DMG-файл или использовать Homebrew: brew install --cask johannesnagl/tap/showmd
2. Активация в системе: Откройте приложение один раз. Перейдите в Системные настройки → Конфиденциальность и безопасность → Расширения → Quick Look. Установите флажок напротив showmd.
3. Первый запуск: При первом открытии macOS может запросить доступ к данным других приложений — нажмите «Разрешить», чтобы расширение могло синхронизировать ваши настройки.
4. Просмотр: Выберите любой файл с расширением .md, .markdown, .mdx или .mdc в Finder и нажмите Пробел.

Кейсы использования (Use Case)

Работа с AI-инструментами

Современные AI-агенты часто создают файлы вроде AGENTS.md или .cursorrules, наполненные специфическими XML-тегами. В обычном текстовом редакторе они выглядят как беспорядочные угловые скобки. showmd превращает их в понятные блоки с метками, делая инструкции для ИИ читаемыми для человека.

Документация и разработка

Если в вашем проекте есть сложные README с диаграммами Mermaid или технические спецификации с формулами LaTeX, вам больше не нужно открывать браузер или тяжелую IDE. С showmd вы видите графики и уравнения прямо в Finder.

Проверка метаданных

Для блогеров и разработчиков, использующих статические генераторы сайтов (Jekyll, Hugo), важно видеть параметры YAML. showmd аккуратно сворачивает их в верхнюю часть документа, позволяя развернуть их только при необходимости.

Часто задаваемые вопросы (FAQ)

Какие расширения файлов поддерживает showmd? Приложение распознает практически все варианты: .md, .markdown, .mdx, .mdc, .rmd, .qmd, .mdown, .mkd, .mkdn, .mdtext и .mdtxt.

Является ли showmd редактором? Нет, это инструмент только для чтения. Его задача — быстро показать содержимое в красивом виде и не мешать вашей работе.

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

Как включить темную тему? Программа автоматически следует системным настройкам macOS, но вы можете принудительно выбрать светлую или темную тему в настройках самого приложения.

Чем showmd лучше аналогов? В отличие от платных конкурентов или сложных опенсорс-проектов без интерфейса настроек, showmd бесплатен, прост в установке через Homebrew и обладает уникальными функциями, такими как рендеринг AI-тегов и обработка YAML-метаданных.