К слову, "шарики" это еще полбеды. Ведь есть и стили таблиц! https://github.com/jgm/pandoc/issues/3275
https://github.com/jgm/pandoc/issues/3275
Со стилями таблиц вопрос решаемый, но нужно хорошо ориентироваться в Word :)

Для таких задач лучше подходят инструменты типа MadCap Flare: там из одного источника (статья) можно создавать разный output (HTML, PDF). И интеграция с гитом тоже есть. В плане таблиц и стилей для красивого PDF генераторы очень уступают. Есть встроенный XML редактор, если нужно в разметке что-то сделать. Редактор CSS. Но такой инструмент стоит много денег. Если бы просто HTML, то однозначно какой-нибудь докузаурус или хьюго. Но вот пдф со стилями и таблицами, это лучше HAT tools.

Но интеграция с гитом там ужасная)

Ну как, коммит, пулл, пуш работают )) А вообще никто не запрещает весь проект кроме билда в гит пулять через VS Code например

Ну эт да)

Единственное, что этот код в гите не docs as code, а просто версионирование. Никаких CI пайплайнов и прочих преимуществ генераторов.

Кстати, по поводу Docs as Code — есть ли какие-то CLI-инструменты в духе proselint для русского языка?

Vale для русского? Вроде, уже обсуждали здесь

Спасибо, поищу! ... Ага, видимо, подразумевалось, что правила для русского языка нужно туда добавить самостоятельно :) Я ожидал чего-то готового в духе Главреда :)

Вопрос с таблицами -- условно решаемый знаниями Micorosft Word (как и с булетами). А если в документе используются таблицы разных стилей? А если заголовок таблицы -- не одна, а две строки. А если мне на каждой странице надо повторять не заголовок, а номера граф? А если нужно задавать стили конкретных ячеек или конкретных строк?

С bullets все несколько сложнее, чем с таблицами, хочу отметить :) В целом, надо понять, Ваш вопрос философский или требуется что-то конкретное. Потому что это вопрос — согласны ли мы пойти по пути унификации и некоторых самоограничений в оформлении или же надо просто плюнуть и писать прямо в Word :)

Это был аргумент в защиту постпроцессинга. Причём в случае с docx постпроцессоров может быть два. На уровне Open XML (быстрый) и на уровне собственно MS Word. Я уверен, что паттерн постпроцессинга хорош даже при отсутствии ограничений, налагаемых Pandoc'ом с его AST

На уровне Word — это через VBA? Вообще, логично считать, что вещи, которые можно сделать с помощью фильтров, лучше так и делать. На этом уровне у нас могут быть свои пользовательские команды и поддержка сразу нескольких целевых платформ. Ведь как без команд на уровне markdown можно будет иначе описать, что у этих двух таблиц должно быть разное оформление? Постобработка сама по себе здесь красиво задачу не решит.

писать в md или txt, ворд та еще фигня про форму а не содержание

Я думаю, большинство людей выбирает Word не потому, что он им очень нравится. Есть примеры, когда есть конкретное требование — документ в Word.

Могу даже байку на тему рассказать. В одном представительном отечественном научном журнале по комп. тематике был выбор для авторов: предоставлять рукопись в Word или в LaTeX. Я специально уточнил в редакции, мол, действительно готовы принять в LaTeX? На что мне ответили, мол, нежелательно, поскольку их специалисты берут LaTeX-документ и ВРУЧНУЮ ПЕРЕДЕЛЫВАЮТ его для Word! :)

Это понятно. Постобработка -- всего лишь часть pipe-line'а. Касательно VBA, мне кажется, лучше делать только операции, связанные с обновлением полей. Генерацию документа и различного рода доформатирование лучше делать с исходным форматом (в данном случае, Open XML). В случае с Asciidoc -> Open Document  таким подходом удалось добиться ситуации, когда загонять себя в рамки ПОЧТИ (важное слово) не нужно.

По поводу проверки текста сделал недавно два открытия для себя. Во-первых, очень много стилистических ошибок в русском языке можно поймать обычными регулярками. И, во-вторых, предложение "На столе лежал мячи" с точки зрения LanguageTool, цитирую: "Выглядит хорошо. Ошибок не найдено". Word'у оно тоже нравится.

А sphinx не подойдёт мне для генерации pdf и html?

Подойдет, конечно.

к MadCap всегда надо делать оговорку: «..., если вы хотите vendor lock для всей компании»

Отлично! Изучаю дальше. А то я день потратила уже на шаблоны latex 😀