Quarkdown Когда Markdown уже мало, а LaTeX еще слишком сложно

Знакомая ситуация? Вы начинаете писать документацию или статью в Markdown. Все идет отлично: просто, быстро, удобно. Но как только дело доходит до сложной верстки, математических формул, кастомных блоков или, не дай бог, оглавления для печати — магия Markdown рассеивается. Приходится либо мириться с ограничениями, либо с тяжелым вздохом открывать редактор LaTeX и вспоминать, как вставить картинку по центру.

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

Что такое Quarkdown и зачем он нужен?

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

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

Это превращает статичный текст в динамический документ, открывая совершенно новые возможности.

Markdown, который умеет в программирование

Давайте посмотрим на магию в действии. Quarkdown вводит концепцию "функций". Выглядит это до боли просто:

.somefunction {arg1} {arg2}
    Body argument

Точка в начале строки говорит компилятору, что это вызов функции. Например, чтобы отцентрировать текст, не нужно никаких HTML-тегов:

.center
    Этот текст будет идеально по центру.

Но это только начало. Вы можете определять свои собственные функции прямо в документе. Например, создадим функцию для приветствия:

.function {greet}
    to from:
    **Привет, .to** от .from!

.greet {мир} from:{iamgio}

Результат будет таким: Привет, мир от iamgio!

Эта, казалось бы, простая возможность полностью меняет правила игры. Можно создавать переиспользуемые компоненты, автоматизировать повторяющиеся задачи и генерировать сложный контент, который был бы невозможен в обычном Markdown. А благодаря богатой стандартной библиотеке, "из коробки" доступны функции для работы с файлами, математикой, условными операторами и сложными элементами верстки.

Один источник — множество форматов

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

• .doctype {plain} — создаст обычную HTML-страницу, похожую на документ в Notion или Obsidian. Идеально для баз знаний и простой документации.
• .doctype {paged} — сгенерирует документ с разбивкой на страницы, готовый к печати или экспорту в PDF. То, что нужно для научных статей, отчетов и книг.
• .doctype {slides} — превратит ваш Markdown в интерактивную презентацию на базе reveal.js.

Пример документа, сверстанного для печати

Больше не нужно переносить контент из одного инструмента в другой, чтобы подготовить презентацию по своей же статье. Все живет в одном месте.

Насколько это удобнее, чем LaTeX?

Многие скажут: "Для серьезных документов есть LaTeX!". И будут правы. LaTeX — это золотой стандарт в академическом мире. Но давайте будем честны, его синтаксис далек от интуитивного, а порог вхождения довольно высок. Quarkdown предлагает компромисс: мощь верстки LaTeX с простотой Markdown.

Сравните сами. Вот как выглядит типичный код в LaTeX и его аналог в Quarkdown:

\tableofcontents
\section{Section}
\subsection{Subsection}
\begin{enumerate}
\item \textbf{First} item
\item \textbf{Second} item
\end{itemize}
\begin{center}
This text is \textit{centered}.
\end{center>

.tableofcontents

# Section

## Subsection

1. **First** item
2. **Second** item

.center
    This text is _centered_.

  </td>

Комментарии, как говорится, излишни. Код на Quarkdown чище, короче и интуитивно понятнее для любого, кто хоть раз писал README.md.

Инструменты для разработчика

Создатели Quarkdown позаботились и об удобстве работы. Проект предлагает:

• CLI-утилиту: для создания проектов, компиляции и запуска.
• Live Preview: Команда quarkdown c file.qd -p -w запускает локальный сервер и автоматически пересобирает и обновляет документ в браузере при каждом сохранении файла.
• Расширение для VS Code: с подсветкой синтаксиса, автодополнением и превью в реальном времени.

Кому стоит попробовать Quarkdown?

На мой взгляд, Quarkdown — это идеальный инструмент для нескольких категорий специалистов:

1. Технических писателей и разработчиков: для создания сложной и интерактивной документации, которая легко экспортируется и в веб, и в PDF.
2. Студентов и ученых: как более простая и современная альтернатива LaTeX для написания курсовых, дипломных и научных статей.
3. Авторов и блогеров: для написания книг и лонгридов, где важен полный контроль над версткой без сложностей профессиональных издательских систем.
4. Спикеров: для быстрого создания стильных интерактивных презентаций прямо из текстовых заметок.

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

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