Hacker News Digest

17 августа 2025 г. в 19:51 • buttondown.com • ⭐ 91 • 💬 81

Original • HN

#markdown#rst#sphinx#python#latex#epub#html

I Prefer RST to Markdown (2024)

  • Markdown = лёгкая обёртка HTML, rST = промежуточное дерево документа.
  • В Markdown картинка: ![alt](img.jpg) → прямое преобразование в <img>.
  • В rST: .. image:: img.jpg :alt: alt → регистрируется обработчик, возвращает объект-узел, который потом рендерится нужным бэкендом.
  • rST расширяем: добавил .. figure::, подключил обработчик — готово.
  • Можно трансформировать дерево до вывода: перенос решений упражнений в конец книги, генерация ссылок, разные стили для HTML, PDF, EPUB.
  • Пример: .. exercise:: Fizzbuzz и .. solution:: собираются в одном месте, но при сборке перемещаются в solutionlist, связываются ссылками, в EPUB открываются всплывающими сносками, в LaTeX — через answers.