Quarkdown: Markdown, дорос­ший до тьюринг-полного языка вёрстки

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

Markdown с функциями

Quarkdown вырос из CommonMark и GFM, но добавил к ним то, чего разметке всегда не хватало, — вызовы функций. Запись вида .somefunction {arg1} {arg2} подключает элементы из расширяемой стандартной библиотеки: компоновка страниц, ввод-вывод, математика, условия и циклы. При желании пользователь описывает собственные функции и переменные прямо внутри документа и даже собирает из них библиотеки для других. Так внутри Markdown появляется настоящий скриптинг, позволяющий строить динамический контент, недостижимый в «ванильной» разметке.

Один исходник — четыре цели

Желаемый тип документа задаётся прямо в тексте через .doctype. Поддерживаются четыре режима: непрерывный поток в духе Notion или Obsidian (plain), постраничная вёрстка для статей и книг на движке paged.js (paged), слайды на reveal.js (slides) и режим документации для вики и больших баз знаний (docs). Всё это экспортируется в HTML, а также в PDF, Markdown и обычный текст.

В README авторы не стесняются сравнивать себя с LaTeX, Typst, AsciiDoc и MDX, и приводят наглядный пример: громоздкая конструкция LaTeX с окружениями figure и subfigure для трёх картинок в ряд сворачивается в Quarkdown до нескольких строк .row с обычными ссылками на изображения. Кривая обучения при этом обещана пологой — синтаксис остаётся узнаваемо маркдауновским.

Прицел на инструменты и агентов

Проект делает ставку и на удобство работы: живой предпросмотр с низкой задержкой, быстрая компиляция (официальная вики из более чем сотни документов, по словам авторов, собирается примерно за две секунды) и расширения для VS Code и IntelliJ IDEA. Отдельно отмечена «дружелюбность к агентам» — в комплекте идёт встроенный skill для кодовых ассистентов. Заявлена и безопасность по умолчанию: ограничительная система разрешений сдерживает доступ к системным ресурсам.

Quarkdown распространяется под GPLv3 (CLI и языковой сервер — под AGPLv3), ставится скриптом или через Homebrew, Scoop и GitHub Actions; браузер для экспорта в PDF подтягивается автоматически. Даже название выдержано в стиле: логотип изображает не планету, а нижний кварк — одну из легчайших элементарных частиц, из которых складывается вся сложная материя. Ровно этот образ, по замыслу авторов, и описывает философию проекта.

Источник: Lobsters