не самый удачный вариант (только что попробовал)

А зачем вообще в такой цепочке md? он ведь явно не конечный продукт? возможно, есть более короткий и прямой способ получения конечного продукта из chm?

цель моего исследования - проверить, можно ли уйти с HM вообще

если hm генерирует chm, то это compiled html, архив с html-файлами, грубо говоря. эти html-файлы можно оттуда извлечь и дальше работать с ними, не привлекая doc

Из hm можно сразу делать html

Разработчики hm обещают конвертацию в MD в будущих версиях

http://helpman.it-authoring.com/viewtopic.php?t=15517

XSLT называется такой инструмент :)
Но писать придется много.

Но вообще, чем плох вариант сделать HTML и из него Md?

Попробую

Он хорош тем, что для обработки HTML есть очень много инструментов, больше чем для других форматов. Считай, на любом популярном языке ты что-то найдёшь

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

Хороший пример: доки по синтаксису языка Elm принесли в сообщения об ошибках в синтаксисе. Теперь эти сообщения помогают изучить синтаксис и исправить ошибку.

Читатель @ejiek подсказал ещё один пример документации прямо в месте ошибки — язык Rust.

Команда rustup docs --book показывает общую документацию языка Rust.

Все ошибки содержат краткое описание и заканчиваются номером ошибки:

For more information about this error, try rustc --explain E0271.

Команда rustc --explain E0271 показывает справку по ошибке и помогает её исправить.

Курс по документации для инженеров.
Google выпустил курс по техдокументации для инженеров. Он состоит из двух частей общей длительностью не больше восьми часов.

Вот и решился вопрос, чем заняться на длинных выходных. :)

а это типо можно просто читать и не нужно записываться на курсы?

Кажется, без записи, да.

о тогда круто

​​Пока кто-нибудь только задумывается о переезде с допотопных CMS на docs-as-code, продвинутые ребята из Lisk переезжают с Markdown на AsciiDoc и Antora.

Хоть я и перетащил на reST пару десятков проектов, для меня в этой статье много полезного. Например, Lisk вместе со сменой инструмента переработали структуру доки. Их топологию можно использовать как «таблицу Менделеева»: про каждый сегмент подумать, а что из нашей документации сюда ложится? Как люди это найдут, как будут читать? А если ничего нет, не стоит ли написать?

Коллеги, привет, ай нид хелп от Hugo специалистов. Решила разучить еще один генератор, генерить сайты через 'hugo server -D' получается, но когда пытаюсь через 'hugo -D'  сложить результат в папочку, дизайн пропадает, то есть на выходе я получаю голый html без стилей и картинок. В инструкциях везде написано как деплоить через разные инструменты, а хочу просто сгенерить статический сайт. Я чего-то не того хочу?   Hugo v0.62.0, macOS.

Просто hugo без параметров?

ага, я попробовала команду hugo и с -D и без, и тему напрямую прописывать в командной строке, ничего не помогает.