showmd

Что такое showmd?

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

Вместо отображения сырого текста при нажатии Space на .md-файл в Finder showmd рендерит Markdown и предоставляет переключатель rendered/source. Кроме того, оно парсит YAML frontmatter в свёрнутую таблицу метаданных, поддерживая распространённые рабочие процессы документации и AI-промптов, зависящие от структуры Markdown.

Ключевые возможности

• Предварительный просмотр Quick Look для Markdown в Finder: Нажмите Space на Markdown-файле, чтобы увидеть отформатированный вывод без открытия браузера или редактора.
• Переключатель rendered ↔ source: Переключайтесь между отрендеренным Markdown и сырым исходным кодом одним кликом.
• YAML frontmatter как свёрнутая таблица метаданных: Обнаруживает «найденные ключи» в frontmatter и показывает их в таблице, свёрнутой по умолчанию.
• Возможности Markdown через парсер Markdown: Поддерживает элементы GitHub Flavored Markdown, такие как таблицы, списки задач, зачёркивание, автоссылки, сноски и многое другое.
• Рендеринг с учётом синтаксиса для кода и специального содержимого: Блоки кода используют подсветку с учётом языка (190+ языков), встроенная и блочная LaTeX-математика рендерится через KaTeX, диаграммы Mermaid — из блоков кода.
• Рендеринг тегов, ориентированный на AI: Пользовательские XML-подобные теги, часто встречающиеся в AI-промптах (например, , , ), отображаются как помеченные рамочные блоки вместо сырого текста с угловыми скобками.
• Без облака или фоновых загрузок: На странице указано «No cloud. No uploads. No telemetry», что означает локальный предварительный просмотр файлов по умолчанию.
• Обработка встроенных изображений в Quick Look: Относительные пути к изображениям разрешаются корректно, так что локальные скриншоты/диаграммы отображаются в предварительном просмотре.

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

1. Скачайте showmd для macOS и откройте его один раз.
2. В System Settings → Privacy & Security → Extensions → Quick Look включите showmd (на странице это описано как одиночный переключатель).
3. В Finder выберите Markdown-файл и нажмите Space, чтобы просмотреть его с помощью showmd.
4. Используйте переключатель rendered/source, чтобы переключаться между отформатированным выводом и исходным Markdown. На странице также упоминается опция копирования как HTML.

Сценарии использования

• Чтение документации в формате Markdown: Просматривайте README-файлы с отформатированными заголовками, списками, ссылками и таблицами, не выходя из Finder.
• Проверка AI-промптов/конфигов в Markdown: Просматривайте файлы инструкций для AI-агентов с XML-подобными тегами, где теги рендерятся как помеченные блоки для быстрого сканирования.
• Просмотр YAML frontmatter в контенте статических сайтов: Разворачивайте таблицу frontmatter при необходимости проверки заголовков или ключей конфигурации, оставляя её свёрнутой при обычном чтении.
• Проверка технического содержимого с кодом, математикой или диаграммами: Видьте подсвеченные блоки кода, LaTeX-выражения и Mermaid-диаграммы, отрендеренные встроенно, а не как сырой текст.
• Проверка относительных изображений в локальных заметках/документах репозитория: Убеждайтесь, что изображения по относительным путям отображаются корректно в предварительном просмотре Quick Look.

FAQ

Как включить showmd в Finder?
Скачайте showmd, откройте его один раз, затем перейдите в System Settings → Privacy & Security → Extensions → Quick Look и включите расширение. При первом запуске macOS может запросить разрешение на доступ к данным других приложений; нажмите Allow.

Заменяет ли showmd необходимость открытия браузера?
На странице showmd позиционируется как способ предварительного просмотра Markdown прямо в Quick Look macOS, без необходимости открывать браузер для отрендеренного вывода.

Можно ли переключаться между отрендеренным выводом и исходным Markdown?
Да. showmd предоставляет переключатель rendered & source, описанный как одиночный клик.

Как showmd обрабатывает YAML frontmatter?
Оно парсит YAML frontmatter в свёрнутую таблицу, свёрнутую по умолчанию, которую можно развернуть для просмотра метаданных.

Есть ли облачная составляющая?
На странице указано «No cloud. No uploads. No telemetry», что указывает на локальную обработку предварительных просмотров по умолчанию.

Альтернативы

• Открывать Markdown-файлы в专用ном просмотрщике/редакторе Markdown: Используйте приложение, предназначенное для рендеринга и экспорта Markdown. Такие варианты часто включают больше инструментов редактирования, в то время как showmd позиционируется специально как просмотрщик Quick Look.
• Использовать браузерный рендерер Markdown: Загружайте или вставляйте содержимое в онлайн-просмотрщик для получения отрендеренного вывода. По сравнению с showmd это добавляет шаг с браузером и может не обеспечивать строгую локальность файлов.
• Полагаться на стандартный Quick Look в macOS: Предварительный просмотр Space в Finder покажет сырой исходный код Markdown. Это самый простой вариант, но менее читаемый для отформатированного содержимого, такого как таблицы, диаграммы и математика.
• Использовать toolchain для документации/статических сайтов для предпросмотра: Локальные dev-серверы могут рендерить Markdown с полным стилем сайта, но обычно они тяжелее workflow предпросмотра Quick Look.