Кстати, по поводу цепочек! А что сейчас принято использовать (CLI-инструменты) для проверки целостности ссылок внутри документов?

foliant сам проверяет

Спасибо, попробую вытащить из него нужную часть.

Playwright кажется наиболее перспективным, но есть также https://github.com/yashaka/selene — питоновский порт selenide — обёртка над selenium. Он будет ближе к тому, что есть

Если речь идёт о таблицах, то наиболее сильным решением с точки зрения критерия удобство/возможности является Asciidoc. Git поддерживает Asciidoc. С превью проблем нет, наверное, ни у каких языков разметки. И для Asciidoc сделал конвертер в OpenOffice, т.е. старое представление сможете тоже оставить. Можно просто настроить github actions, который будут автоматически собирать OpenOffice документ при внесении изменений в hardware design notes

Чем можно пользоваться, чтобы сразу генерировать pandoc'овский preview из md-документа с вставленными latex-таблицами

Хороший вопрос! Думаю, это возможно только через просмотр pdf, без LaTeX-компилятора в этой задаче не обойтись. Хотя существует же предпросмотр для формул, возможно, есть что-то подобное для таблиц.

Спасибо

Спасибо! С Asciidoc дело пока что не имел, так что посмотрю! И хороший вопрос насчёт генерирования привью через пандок. На днях постараюсь разобраться, тогда поделюсь информацией, если найду что то полезное.

«Сложные» это «с объединенными ячейками» или что?

Объединённые ячейки по вертикали и горизонтали, списки внутри, часто нужно иметь возможность задавать ширину столбцов, так же бывают сноски или примечания.

«Список в ячейке таблицы» все-таки звучит прежде всего как повод переделать таблицу.

Объединенные ячейки это полезно, и это даже Org не может, жаль.  Хотя, думаю, еще сможет, и кто-нибудь, небось, уже написал свой вариант решения этой проблемы.

А что такое Org?

org-mode, уже упомянутый чуть выше.

В принципе, ничего мощнее его для доков в чистом тексте нету, но ≈никто не пользуется.

В офисных пакетах и в LaTeX такие таблицы просто создавать. Но для docs-as-code оба не очень подходят. Вот поэтому и думаю как можно скомбинировать.

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

Тут не могу согласиться. Повторю свое сообщение выше. И даже добавлю. И список внутри таблицы. И таблица внутри списка. И таблица в таблице. И картинка в таблице. И код в таблице. И много абзацев в таблице. И всевозможные сноски. И объединения по вертикали/по горизонтали. И заголовок таблицы, состоящий из нескольких строк. И возможность повторять на каждой странице не заголовок, а названия граф. И возможность задавать различные стили для ячеек/столбцов/строк таблицы. И задание ширин для столбцов. Всё это нужно в разных ситуациях. Зависит от вида выпускаемого документа.

Я понимаю, если всё это не  достижимо. Но достижимо же.

О, Орг может?  И по горизонтали тоже?  Я думал, там автовыравнивание не даст.

Ну тогда он все может из того, что явно полезно.

по горизонтали не проверял, это я ща на SO загуглил, проверил - работает, может быть с более сложным форматированием/объединениями не справится, конечно