По умолчанию Asciidoctor использует для рендеринга формул MathJax. Если нужен LaTeX, придётся использовать гем asciidoctor-mathematical.
Чтобы этот гем нормально установился и скомпилировался, в Debian и Ubuntu поставьте эти пакеты:
sudo apt-get install \
bison \
cmake \
flex \
fonts-lyx \
libcairo2-dev \
libffi-dev \
libgdk-pixbuf2.0-dev \
libpango1.0-dev \
libwebp-dev \
libxml2-dev \
libzstd-dev \
ruby-dev
В скрипте сборки не забудьте указать нужные параметры:
bundle exec asciidoctor \
--attribute stem:latexmath \
-r asciidoctor-mathematical \
...
README проекта asciidoctor-mathematical содержит ошибку, там не хватает пакета ruby-dev для Debian и Ubuntu. PR я уже отправил, подождём когда вольют.
Обновление от 18 февраля 2026 года
This gem is no longer actively maintained, largely due to its complex dependencies and bad rendering. Please use
asciidoctor-pdf-mathjaxorasciidoctor-mathjax.jsfor a better experience.