On a sidenote: the article is also available as #PDF thanks to #AsciiDoc which works OK with #Hugo for the website but even better for the PDF

Both HTML and PDF are derived from the same source, thanks to tags and includes.

https://www.cryptomancer.de/posts/20250825-pqckeysize/PQC-OpenSSL-Benchmark.pdf

@b0rk

Yes, but you're operating at a level higher than that. You're looking at ASCIIDOC that has been converted into some macro-set, that then becomes roff (or is interpreted directly in some cases). I'm guessing asciidoctor.

asciidoctor appears, from a quick shufti of the source, to generate output that targets the "an" macro set rather than the "doc" macro set. For the particular page you've mentioned it is generating conditional code that either directly moves the horizontal position with \h, or uses the .IP macro to make an indented paragraph with a hanging bullet.

https://github.com/asciidoctor/asciidoctor/blob/main/lib/asciidoctor/converter/manpage.rb#L496

In both cases, the indent is directly hardwired into the asciidoctor source. As you can see, it moves -4 ens right (i.e. 4 ens left) and 3 ens back with \h, and in the alternative fork gives the .IP macro the indent setting 2.3.

https://oreilly.com/openbook/utp/

https://cmd.inp.nsk.su/old/cmd2/manuals/unix/UNIX_Unleashed/ch09.htm

My educated guess is that -4 and 2.3, unchanged since 2015, were copied from some other tool.

#man #asciidoc

asciidoctor/lib/asciidoctor/converter/manpage.rb at main · asciidoctor/asciidoctor

:gem: A fast, open source text processor and publishing toolchain, written in Ruby, for converting AsciiDoc content to HTML 5, DocBook 5, and other formats. - asciidoctor/asciidoctor

GitHub

#Markdown Is a Disaster: Why and What to Do Instead
https://karl-voit.at/2025/08/17/Markdown-disaster/

Here's my article where I summarize the subtle and no so subtle downsides when you choose Markdown for your information instead of a different markup syntax that doesn't come with all the downsides of #MD.

#publicvoit #orgdown #orgmode #LML #pandoc #rst #restructuredtext #asciidoc #Wikitext #BBCode #Creole #Crossmark #Djot #CommonMark #lockin

Markdown Is a Disaster: Why and What to Do Instead

Markdown Is a Disaster: Why and What to Do Instead

public voit - Web-page of Karl Voit

Writing a book using #asciidoctor ?

This is how you switch off running headers on chapter title pages (only took me three weeks to work out!). NB Calling super 1st is important.

# https://www.rubydoc.info/gems/asciidoctor-pdf/Asciidoctor/PDF/Converter#ink_chapter_title-instance_method

class PDFConverterCustomPartTitle < (Asciidoctor::Converter.for 'pdf')
register_for 'pdf'

def start_new_chapter chapter
super
page.imported
end
end

#asciidoc

RubyDoc.info: Class: Asciidoctor::PDF::Converter – Documentation for asciidoctor-pdf (2.3.19) – RubyDoc.info

Documenting RubyGems, Stdlib, and GitHub Projects

Spring REST Docs는 #AsciiDoc 쓰면서 왜 이름은 헷갈리게 REST로 지은 거야.
RE:
#разметка #typst #orgmode #asciidoc
@rur
Продолжение темы заметок и прочего.

Я вот что думаю: А почему бы не сделать так:
Заметки/todo -
org-mode;
Конспекты - на первое время ASCIIDoc, а там может быть typst;
Ежедневник - asciidoc.

Хотя это лишь зачатки, ибо в org-mode можно и ежедневник запилить. Но тут надо глянуть подробнее.
SkullGamer205 :AwAtix: (@skullgamer205)

#разметка #tex #markdown #typst @rur@social.sley.nl @rf@mastodon.ml @Russia@3zi.ru Добрый вечер ребят. У меня зародился такой вот вопрос: Какой язык разметки вы можете посоветовать для ведения своего личного дневника, заметок, ну и для всяких документиков? Просто появилось желание изучить какой-нибудь язык разметки (кроме markdown (и нет, я ничего не имею против)) и использовать его активно. На самом деле, хочу использовать в нескольких местах: Хочется попробовать заиметь свой мини-ежедневник/дневник со своими мыслями, чтоб можно было неплохо оформить; чтоб можно было вести список дел (todo); ну и самок изощрённое - верстать документы немножечно посерьёзнее (скажем, конспекты или (мини-)доклады). Я пользуюсь markdown для ведения заметок. Он весьма простой, удобный и всяких android и linux приложух немало. И с синхронизацией проблем нет. Но из-за своей простоты он, как-будто, ограничен в функционале. Пока делал курсовую, наткнулся на LaTeX, но не особо его попробовал. Слышал, что он очень сложный и муторный. Видел Lua(La)Tex. Тот же (La)TeX, но с подключенным Lua. Заметил, что LaTeX всё дело пакует в pdf, и не заметил быстрого предпросмотра. Всё это чутка напрягло. Недавно наткнулся на [Quarkdown[(https://github.com/iamgio/quarkdown). Весьма расширенный markdown, который может в развёртку, pdf и html. Даже синтаксис тот же. И вроде всё интересно и радужно, но одно но: Мало чего ечть для него. Android приложения, реализации блокнотов и пр. нет. И это немного напрягает. Также наткнулся на [Typst](https://github.com/typst/typst) с несложным синтаксисом. И о нём, похоже, многие наслышаны. Даже гайды есть. Для заметок также может быть хорош `org-mode`. Но вот что-то одно выбрать так и не могу. Вот и хочу вас спросить по этому поводу. Есть ли какие-либо идеи? Может скорее выбрать несколько, но под разные задачи?

[Shitpost] PoridgeClub
Oui, c'est une vieille version de Font Awesome, mais c'est celle qui est utilisée par Asciidoc, c'est donc une page plus qu'utile pour moi https://fontawesome.com/v4/icons/ #asciidoc #glyphicon #icon #catalog
Font Awesome Icons

Font Awesome, the iconic font and CSS framework

@DJGummikuh @dashorst @cstamas @khmarbaise I don't use that thing, I always do #asciidoc (which has a descriptive, non tongue-in-cheek, clear name)

Wanted to re-acquaint myself with #AsciiDoc workflow so I manually reformatted a 20-year-old #TTRPG PDF I know well. Tables, callouts, footnotes, document metadata, all the stuff that can be bolted-on to #Markdown but is built into AsciiDoc.

It took a fair bit of my day off yesterday, and was arguably yak-shaving, but worth it in the end to have The Ultimate Version of the document I've used for decades.

마크다운으로 문서를 작성하고 싶다고요?
글쎄요. 프로그래머는 Markdown에 MDX라는 프로그래머들만의 전문직화 기법을 씁니다.
AsciiDoc은 되어야 우리가 일상에서 읽는 책에 쓰이는 문서의 기본을 구문만으로 작성하고 산출/인쇄할 수 있습니다.

#Markdown #AsciiDoc