MD Viewer: просмотрщик Markdown без браузерного движка

Большинство «просмотрщиков Markdown» для Windows — это браузер в плаще: WebView2, локальный сервер, страница с подсветкой. Работает, но стартует секундами, ест память под движок и требует установленного рантайма. MD Viewer 1.3.3 идёт другим путём: просмотрщик Markdown, который сам разбирает документ, сам считает переносы строк и сам рисует буквы через GDI+. Один самодостаточный mdview.exe, без .NET-рантайма в системе, без CDN и без телеметрии. Ниже — что он умеет, как устроен, что показали замеры релиза (размеры, версии, хеши) и где границы: от Windows-only до подмножества Mermaid.

TL;DR: что это и как проверить за десять минут

1. Что это. Нативное WinForms-приложение с собственным разборщиком Markdown и собственной вёрсткой, отрисовка через GDI+.
2. Требования. Windows 10 1809+ или Windows 11 (x64) — и больше ничего: ни .NET, ни WebView2, ни шрифтов.
3. Три режима: Rendered (Ctrl+R), Source (Ctrl+U), Editor (Ctrl+E) с предпросмотром.
4. Командная строка: режим, тема, зум, ширина колонки, номер строки, экспорт, печать, скриншот.
5. Установка: MD.Viewer-1.3.3-setup.exe (34,8 МБ) или портативный mdview.exe (52,5 МБ).

.\mdview.exe notes.md                                   # открыть документ
.\mdview.exe notes.md --mode editor --theme dark --zoom 1.25 --line 40
.\mdview.exe notes.md --export html                     # экспорт рядом с источником
(Get-Item .\mdview.exe).VersionInfo.FileVersion          # 1.3.3.0

Проблема, которую это решает

Просмотр Markdown на Windows — задача, которую вроде бы решили десять раз. На практике у каждого решения свой минус. Редактор кода умеет предпросмотр, но это редактор: открывать в нём чужой README.md — как стрелять из пушки по воробьям. Браузерное расширение требует браузера и разрешений. Веб-просмотрщик на локальном сервере занимает порт и тянет зависимости.

Отдельная проблема — среда. На чистой Windows есть только .NET Framework 4.8, а современные сборки рассчитывают на .NET 8 или новее, которых в системе нет. Приложение, зависящее от рантайма, на чистой машине просто не запустится, и это выясняется в самый неподходящий момент.

Третья — доверие. Просмотрщик, исполняющий HTML из документа, превращает любой скачанный README.md в потенциальную точку входа. Здесь это решено жёстко: сырой HTML не исполняется никогда, а показывается карточкой исходника.

Что такое MD Viewer

flowchart TB
  EXE["mdview.exe: один файл"] --> RT["встроенный рантайм .NET"]
  EXE --> APP["приложение: около 74 КБ"]
  APP --> SHELL["оболочка WinForms: вкладки, меню, поиск"]
  SHELL --> PARSER["свой разборщик Markdown: CommonMark + GFM + расширения"]
  PARSER --> LAYOUT["свой движок разметки: строки, таблицы, карточки кода"]
  LAYOUT --> PAINT["отрисовка через GDI+"]
  PAINT --> SCREEN["окно: режимы Rendered, Source, Editor"]

Один файл mdview.exe — это приложение плюс встроенный рантайм. По данным README, из 52,5 МБ примерно 50 МБ занимает рантайм и около 74 КБ — само приложение. Именно поэтому оно запускается на машине, где никакого .NET нет.

Возможности

Просмотр и навигация

Вывод и интеграция

Автоматизация

Поддержка Markdown

flowchart LR
  F["файл .md"] --> W{"режим"}
  W -- Rendered --> P["разбор Markdown"]
  W -- Source --> S["подсветка синтаксиса, номера строк"]
  W -- Editor --> E["редактор плюс предпросмотр через 220 мс"]
  P --> M["математика, Mermaid, таблицы, сноски"]
  M --> L["своя разметка и переносы"]
  L --> G["GDI+ отрисовка"]
  E --> P

Важная деталь про Mermaid: диаграммы рисуются своим кодом, а не через JavaScript-библиотеку. Для просмотрщика без браузерного движка это единственный способ — и одновременно ограничение: набор типов диаграмм фиксированный, новые типы появятся только с версией приложения.

Чего он намеренно не делает

Это стоит читать не как «недостатки», а как границы выбора: каждое из этих решений что-то упрощает и чем-то платит.

Как это устроено внутри

flowchart TD
  CLI["командная строка: --mode, --theme, --zoom, --width, --line"] --> VIEW["стартовое состояние окна"]
  MENU["меню View: тема, запоминать режим, контур"] --> VIEW
  FILE["--no-session и --export html|png|txt"] --> OUT["сессия или файл на диске"]
  VIEW --> SAVE["сессия до 8 вкладок"]

Цепочка проста и от этого предсказуема: файл → разбор Markdown → собственная разметка (строки, таблицы, карточки кода, диаграммы) → отрисовка через GDI+. Ни один шаг не обращается к браузеру, поэтому и старт быстрый.

Вторая часть устройства — окно. Оболочка WinForms отвечает за вкладки, меню, поиск и панель контура; каждый документ хранит своё состояние (прокрутка, каретка, режим). Сессия до восьми вкладок сохраняется между запусками, но режим просмотра по умолчанию не восстанавливается — файл всегда открывается отрисованным, пока в меню не включено «Remember the last view mode».

Замеры и цифры

Снято 09.11.2026: скачаны оба файла релиза, проверены версия и контрольные суммы.

Три вывода. Первый: ProductVersion содержит хеш коммита — по нему видно, из какого состояния собран файл, и это удобнее, чем сверять дату. Второй: портативная сборка тяжелее установщика, потому что внутри лежит самодостаточный рантайм; установщик распаковывает то же самое. Третий: SHA256SUMS в этом релизе не приложен — контрольные суммы я считал сам, и сверить их можно только с этой таблицей или с повторной сборкой, а не с файлом от автора.

Чего замеры не показывают: я не запускал интерфейс и не проверял отрисовку, экспорт и печать вживую — это GUI-приложение, а прогон шёл без интерактивного рабочего стола. Всё, что касается поведения окна, взято из README и заметок к релизу.

Сильные стороны продукта

• Стартует без зависимостей. Рантайм внутри файла: на чистой Windows не нужно ничего доустанавливать.
• Свой разбор и своя вёрстка. Нет браузерного движка — нет и его памяти, и его задержек.
• Безопасный по умолчанию. Сырой HTML не исполняется, а показывается карточкой исходника.
• Три режима в одном окне. Читать, смотреть исходник и править можно без смены программы.
• Скриптуется. Режим, тема, зум, переход к строке, экспорт и печать доступны из командной строки.
• Диаграммы без JavaScript. Mermaid рисуется своим кодом, поэтому вид одинаков в офлайне.
• Аккуратная работа с файлами. Живая перезагрузка при изменении на диске, сессия из восьми вкладок.
• Один файл для переноса. Портативная сборка кладётся рядом с документами и не оставляет следов.

Сравнение с альтернативами

Выбор здесь не про «лучше или хуже», а про частоту задачи. Если Markdown открывается несколько раз в день — нативный просмотрщик экономит секунды на каждом открытии. Если раз в неделю — разницы не заметите, и хватит того, что уже стоит.

Правки версии 1.3.3

Две правки, обе про поведение по умолчанию, а не про новые возможности.

Значок кнопки теперь показывает то, что на экране, а точка отмечает режим «следовать Windows». Полный выбор из трёх состояний остался в меню View → Theme. Запоминание режима включается отдельным пунктом View → Remember the last view mode — тем, кому удобнее возвращаться в редактор.

Работа с документом

Один типичный день выглядит так. Утром открывается чужой README.md из архива — двойным кликом или перетаскиванием в окно; документ сразу отрисован, без «выберите программу». По ходу чтения Ctrl+\ открывает контур, Ctrl+F ищет строку, Ctrl+колесо увеличивает таблицу.

Дальше нужно поправить пару абзацев — Ctrl+E переключает в редактор, Ctrl+Shift+P делит окно на редактор и предпросмотр, который обновляется через 220 мс после остановки ввода. Файл меняется на диске — вкладка перечитывает его сама, если открыта на просмотр.

В конце — отдать результат: --export html создаёт автономную страницу рядом с источником, Ctrl+P печатает в «Microsoft Print to PDF». Закрыть окно и вернуться через день — сессия до восьми вкладок вернётся, но каждая откроется в отрисованном виде, если не включено запоминание режима.

Установка

# вариант 1: установщик
# запустить MD.Viewer-1.3.3-setup.exe: путь C:\Program Files\Deynekin\MD.Viewer,
# запись в «Установленные приложения», ярлыки, ассоциация .md

# вариант 2: портативно
.\mdview.exe

Настройка

Подводные камни

• SHA256SUMS в релизе нет. Хеши в таблице выше — мои; для сверки сохраните их у себя или соберите из тега.
• Портативная сборка больше установщика. 52,5 МБ против 36,5 МБ — внутри рантайм, а не «лишние данные».
• Только Windows. x64, Windows 10 1809+ и Windows 11; на Linux и macOS сборок нет.
• Mermaid — подмножество. Семь типов диаграмм рисуются нативно, остальные показываются карточкой с диагностикой; это не «сломалось», это граница реализации.
• Сырой HTML не работает. Вставка <div> или <table> в документ даст карточку исходника: так задумано, но при переносе документа из другого просмотрщика это заметно.
• Режим не восстанавливается сам. Файл открывается отрисованным, пока не включено «Remember the last view mode» — иначе путаница «почему я снова в редакторе».
• Кнопка темы изменилась в 1.3.3. Раньше цикл был Auto → Light → Dark и первый клик в тёмной Windows ничего не менял; теперь один клик переключает светлую и тёмную.
• Лицензия некоммерческая. PolyForm Noncommercial 1.0.0: для рабочего использования вне личных задач нужен отдельный разговор с автором.
• Тесты — не гарантия поведения GUI. 146 проверок касаются разбора и логики, а не того, как выглядит отрисовка на вашем мониторе.

Диаграммы без браузера

Отдельно стоит сказать про Mermaid, потому что это самая необычная часть. В браузерных просмотрщиках диаграммы рисует JavaScript-библиотека: она грузится со CDN или из папки и превращает текст в SVG. Здесь браузера нет, поэтому диаграммы строит собственный код: он разбирает описание графа, вычисляет расположение вершин и рёбер и рисует результат через GDI+.

Практический смысл такой схемы: документ с диаграммой открывается одинаково в офлайне и без сети, а неподдержанный тип не ломает страницу — вы видите сам код и понимаете, что произошло. Цена — фиксированный список: новый тип диаграммы появится только вместе с новой версией приложения, а не с обновлением библиотеки.

Ограничения и как с ними жить

Почему это работает быстро

Причин три, и все — следствие того, что приложение не оборачивает браузер.

Первая — нет инициализации движка. Браузерный просмотрщик стартует WebView2, поднимает процесс рендерера, загружает страницу с подсветкой и только потом показывает текст. Нативный просмотрщик читает файл и сразу рисует: шагов, на которых можно задержаться, просто нет.

Вторая — вёрстка считается один раз. Разметка документа вычисляется при загрузке и пересчитывается только при изменении ширины колонки или масштаба, а не на каждой перерисовке окна.

Третья — нет внешних ресурсов. Ни шрифтов с CDN, ни картинок оформления: Segoe UI, Consolas и Cambria есть в Windows. Поэтому вид одинаков в любой момент, в том числе без сети.

Отсюда и практический вывод: выигрыш заметен не по одному открытию, а по десятку в день — там, где секунды складываются в минуты.

Чек-лист

• [ ] Проверить версию Windows (10 1809+ или 11, x64).
• [ ] Выбрать установщик или портативную сборку.
• [ ] Сверить FileVersion с ожидаемой версией.
• [ ] Открыть документ с таблицами, кодом и сноской — проверить вёрстку.
• [ ] Открыть документ с диаграммой Mermaid поддерживаемого типа.
• [ ] Проверить тёмную тему и «следовать Windows».
• [ ] Попробовать экспорт в HTML и печать в PDF.
• [ ] Включить или выключить «Remember the last view mode» осознанно.
• [ ] Записать версию и хеш файла в паспорт рабочего места.

FAQ

Итог

MD Viewer 1.3.3 — редкий случай, когда «нативный» означает буквально: свой разборщик Markdown, своя разметка, отрисовка через GDI+, без браузера и без внешнего рантайма. За это платят размером файла и платформой: 52,5 МБ и только Windows. Зато запуск не зависит от того, что установлено в системе, а сырой HTML из документа не исполняется по решению автора, а не по настройке. Замеры простые и проверяемые: FileVersion 1.3.3.0, ProductVersion с хешем коммита, два файла с посчитанными SHA-256 — и ни одного SHA256SUMS от автора, что стоит учитывать при сверке.

Цитата: Просмотрщик документов должен открываться быстрее, чем вы успеете подумать, чем бы вы его ни открывали — иначе им просто не пользуются.

Связанные материалы

• Репозиторий MD.Viewer.Windows — код, документация, матрица поддержки Markdown.
• Релиз v1.3.3 — заметки и оба файла сборки.
• github-agent 1.3.0 — инструмент проверки репозиториев, которым удобно проверять документацию к таким проектам.
• PHP Shield: файрвол для PHP — про то, как отделить проверенное запуском от обещанного в README.
• Bash WP-CLI Update 8.1.0 — ещё один нативный инструмент с проверяемыми кодами выхода.

LLM Summary

• Тема: MD Viewer 1.3.3 — нативный просмотрщик и редактор Markdown для Windows 10/11 с собственным разборщиком и отрисовкой через GDI+.
• Стек: C# 15 и .NET 11, WinForms; самодостаточный mdview.exe, рантайм внутри файла (~50 МБ рантайма и ~74 КБ приложения по README).
• Режимы: Rendered (Ctrl+R), Source (Ctrl+U), Editor (Ctrl+E), плюс предпросмотр через 220 мс после остановки ввода.
• Поддержка Markdown: CommonMark, GFM и расширения MD.Scribe: таблицы, задачи, сноски, [TOC], YAML front matter, GitHub alerts, математика TeX-подмножеством, нативные Mermaid-диаграммы семи типов.
• Безопасность: сырой HTML из документа никогда не исполняется — показывается карточкой исходника.
• Замеры 09.11.2026: установщик 36 470 201 байт, портативная сборка 52 571 622 байта; FileVersion 1.3.3.0, ProductVersion 1.3.3+bba3bc7…, издатель Mikhail Deynekin; SHA-256 exe 8b1a450f…f2fa70, установщика 12929a42…e9b68; SHA256SUMS в релизе отсутствует.
• Что нового в 1.3.3: кнопка темы переключает светлую и тёмную за один клик; файлы открываются в отрисованном виде, если не включено запоминание режима.
• Ограничения: только Windows x64; Mermaid — фиксированное подмножество; сырой HTML не работает; лицензия PolyForm Noncommercial 1.0.0.
• Не проверялось: запуск интерфейса, отрисовка, экспорт и печать — прогон без интерактивного рабочего стола.
• Ссылки: https://github.com/paulmann/MD.Viewer.Windows, https://github.com/paulmann/MD.Viewer.Windows/releases/tag/v1.3.3

Промт для агента (установка и настройка)

Готовый промт для AI-агента: скопируйте блок целиком. В репозитории MD.Viewer.Windows файла AGENTS.md нет, источник шагов — README.md и заметки к релизу 1.3.3; всё, что нельзя проверить запуском, в статье помечено.

Задача: поставить MD Viewer на Windows-машину, сверить версию и убедиться, что он открывает документы с таблицами, кодом и диаграммами.

Материалы:
- репозиторий: https://github.com/paulmann/MD.Viewer.Windows
- README (требования, режимы, опции командной строки): https://github.com/paulmann/MD.Viewer.Windows/blob/main/README.md
- релиз: https://github.com/paulmann/MD.Viewer.Windows/releases/tag/v1.3.3
- AGENTS.md в репозитории нет; ориентир — README

Шаг 1. Проверить систему: Windows 10 1809+ или 11, архитектура x64.
Шаг 2. Скачать оба файла релиза: MD.Viewer-1.3.3-setup.exe и mdview.exe.
Шаг 3. Сверить версию и посчитать хеши (SHA256SUMS в релизе нет):
(Get-Item .\mdview.exe).VersionInfo.FileVersion        # ожидается 1.3.3.0
Get-FileHash .\mdview.exe -Algorithm SHA256
Шаг 4. Установить (или использовать портативно) и открыть тестовый документ.
Шаг 5. Проверить три режима: --mode render, --mode source, --mode editor.
Шаг 6. Проверить экспорт и печать: --export html, --print.
Шаг 7. Проверить диаграмму поддержанного типа (flowchart или pie) и один неподдержанный тип — должен появиться исходник с диагностикой.
Шаг 8. Решить судьбу настройки View → Remember the last view mode и записать решение.
Шаг 9. Записать в паспорт машины версию и SHA-256 файла.

Запрещено:
- считать отсутствие SHA256SUMS гарантией целостности: хеши считаются локально и сверяются с записанными;
- ожидать работу произвольного Mermaid: поддерживается фиксированный список типов;
- вставлять сырой HTML в документ и ждать его отображения: он показывается как исходник;
- ставить продукт на Linux или macOS: сборок нет;
- использовать в коммерческих задачах без отдельного соглашения: лицензия PolyForm Noncommercial 1.0.0.

Что считать успехом: файл открывается в отрисованном виде, три режима переключаются, экспорт создаёт файл рядом с источником, диаграмма поддержанного типа рисуется, версия и хеш записаны.