Как вариант, или все таки лучше ручками внести, без конвертации, как правило заказчик все таки не исправляет весь документ, ну я не помню такого, а правок 20-30 по финальной правке, наверное, вполне реально внести

Кунг фу)

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

Я уточню, чтобы понятно было в чём проблема

Даже обычный перенос строки через WYSIWYG десятком способов может отразиться на внутренней структуре docx

1. Line break <w:br/>
2. Закрыть предыдующий блок, line break, открыть следующий </w:t><w:br/><w:t>
3. </w:t></w:r><w:r><w:br/><w:t xml:space="preserve">

И так далее

Диффать картинки ворда)

Точно)))

С ужасом вспоминаю последовательности из чередующихся обычных и неразрывных пробелов. А ещё штуки вроде <a><strong>...</a></strong>

Во-во!

А ещё нумерованные списки, которые плодят теги при включении/выключении режима нумерованного списка

Файлы изображений, которые из media могут не удаляться при удалении самого блока картинки

Дифф, который делают Ворд/Libre Office исключительно удобные и качественные. Мне кажется, тут больше выдумывать ничего не надо

Эх, я пещерный человек и не знаю, что там есть свой дифф. )

Ладно, забыли про конвертацию из ворда обратно в мд)

Там в формате и его реализациях дикое наслоение вековых костылей, из-за которых конвертация docx->md, мягко скажем, недетерменированная)

Попался на проблеме молотка )

Обсуждений было много, насколько я помню, основных аргумента против Ворд/Odt в качестве исходника, три

1. Обычно, правка в одном документе ведёт к аналогичным правкам в других. Т.е. Ворд/Odt не поддерживают технологию единого источника
2. Семантическая разметка, о которой сказал Николай. Исключительно важно, если мы готовим не промокашку
3. Возможность автоматической генерации документации: API, структура БД и т.п.

Версионирование, конечно, тоже плюс. Но этот плюс применим только при использовании md, Asciidoc, reStructuredText. В случае DITA и Docbook -- тут я преимуществ относительно Ворд/Odt не вижу.

Я тут еще спросил коллегу, почему он не готов вернуться в ворд. Он сказал, что в ворде документы создавать тупо дольше.

Это же два аргумента: 1) тупо и 2) дольше. :)

Ворд поддерживает технологию единого источника. Но платно.

Хорошая автоматизация как раз сэкономит время на правки. Правка — 1 минута, сделать коммит — ещё 1 минута, автоматизированная сборка docx — ещё несколько минут. Но зато мы эти правки никогда не потеряем.

Ну да. Документацию надо создавать в вордЕ, ПРАВИЛЬНО!

Через облако?