ну и зря) довольно полезное и максимально полное сообщество для техписов))

я не техписатель а программист-мимокрокодил. Этого сообщества более чем достаточно

там половина таких

Есть интересная книга про языки разметок и написание своих:
https://xmlpress.net/publications/structured-writing/

В зависимости от контента, иногда имеет смысл заморочиться над своим языком и алгоритмами обработки исходной информации и ее превращения в готовый документ.

Если коротко, что там обсуждали, то там автор как-то оставил за скобками asciidoc, который вроде всем его требованиям отвечает, на что ему указали. И что самые популярные стандарты в общем-то создавались не писателями и не для писателей, поэтому странно от них ожидать учета запроса на structured writing примочки типа procedures, steps, definition lists, reuse и прочего

глядя на постоянный поток вопросов и то что мне пришлось править код!!! чтобы немного изменить нумерацию параграфов вызывает сомнения то что аскидок подходит

подходит для чего? там у автора был конкретный набор критериев в статье же, обсуждение шло именно вокруг них, а не в формате какой язык круче, серебряной пули нет понятное дело, всем приходится так или иначе расширять разметку под себя или адаптировать

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

Зачем вообще нумеровать?  Это только вносит сложности.

Если начинаешь нумеровать, самое заметное что получаешь — несовместимости в ссылках на текст в будущих версиях.  Долой нумерацию.  Нумерация устарела.

еще одна фича: нумерация должна генерить пермалинки которые стабильны от билда к билду

что само по себе компьютером не решается, а следовательно требует постоянного вовлечения человека

А, ну это ж Тонский, он ещё и не такого понапишет...

Долой нумерацию параграфов. В современном документообороте нет реальных кейсов для нумерации. Спрашивал у юристов, никто толком не может обосновать зачем им нумерация параграфов. Что-то говорят про реестр разногласий, допсоглашения, но в реальности, способ этих процессов сильно изменился в последние 20 лет с полным переходом на электронный обмен рабочими версиями

номер параграфа нужен только для того, чтобы быстро найти один нужный в списке из 10…50…100 однородных

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

Нумеровать абзацы можно по-разному, и потребность нумеровать, действительно, достаточно экзотична для современной документации. Вполне логично, что настройка такой экзотики делается с помощью кода (расширением существующей разметки, причём, в данном случае, минимальной). Если же задача типовая, наверняка, кто-то написал или напишет расширение для всех.

Когда речь про бумажную версию, да

Я тут который год выясняю, зачем люди нумерацию строк используют в редакторе

Номера не несут никакой нагрузки, ещё и неоптимальные из-за ограниченного множества цифр

Навигация по номеру строки — это удобно, особенно при работе с документацией. Мне часто проще запомнить номер, чем ставить маркер