asciidoc

;;; -- mode: org; --

https://asciidoc.org/ - adoc (шикарное расширение ;)), сделан под конвертацию в DocBook XML, и далее во что понадобится из вариантов оттуда. (https://en.wikipedia.org/wiki/AsciiDoc). https://asciidoctor.org/docs/asciidoc-writers-guide/.

Менее популярен, чем markdown, но тоже представлен в техрайтерском деле. Наряду с rst.

• https://docs-as-co.de/news/create-docx/ - тоже docx.

• https://github.com/bbatsov/adoc-mode — мод для emacs, ставится через melpa. Как минимум, неплохо умеет подсветку и структуру. https://metaredux.com/posts/2023/03/12/adoc-mode-reborn.html – немного про историю.

  • sophisticated highlighting
  • native fontification of code blocks
  • toggle between the display of image links and the display of the corresponding images
  • promote / demote title
  • toggle title type between one line title and two line title
  • adjust underline length of a two line title to match title text’s length
  • goto anchor defining a given id, default reading from xref at point
  • support for outline (however only with the one-line title style)

• asciidoctor – конвертилка и отчасти проверялка.
• https://docs.asciidoctor.org/pdf-converter/latest/theme/ – про темы для pdf. В том числе колонтитулы и номера страниц.

В принципе, способов получить pdf более одного, но кажется, asciidoctor-pdf — наиболее популярный.