Что такое WordToMD?

Наша миссия

WordToMD существует, чтобы решить конкретную, распространенную проблему: получить контент из документов Word и в Markdown без ручной форматировки. Будь то разработчик, который пишет документацию, писатель, ведущий блог, или организации, мигрирующей на базу знаний шаг преобразования Word-to-Markdown не должен быть болезненным.

Как это работает

WordToMD поддерживается двумя отличными библиотеками с открытым исходным кодом:

• mammoth.js Читает файлы .docx в браузере через API FileReader и преобразует их в чистый HTML, отображая стили Word (Заголовок 1, Заголовок 2, и т.д.) к их HTML эквивалентам.
• turndown Преобразует HTML-вывод из mammoth в стандартный Markdown, с пользовательскими правилами для таблиц (GitHub Flavored Markdown), блоков кода, и другие элементы.

Весь канал проходит внутри вкладки браузера. Файл читается с помощью FileReader API, никогда не передавался по сети.

Первое место - уход за частной жизнью

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

WordToMD архитектурно отличается: логика конверсии работает в JavaScript в вкладке браузера. Байты файла никогда не покидают устройство. Вы можете проверить это, открыв в браузере вкладку Сеть (F12) перед конвертацией вы увидите нулевые запросы на загрузку файлов.

Что сохраняется

Следующие Word элементы надежно конвертируются:

• Заголовки (H1H6) → Заголовки типа ATX Markdown
• Смело (** Текст**) и курсивным (_текст_) форматирование
• Порядочные и непорядочные списки, включая вложенные списки
• Таблицы → GitHub Ароматизированные Markdown синтаксис таблицы
• Гиперссылки с якорным текстом
• Монопространство / текст с кодовым стилем
• Все символы Unicode (китайский, японский, арабский, эмодзи и т.д.)

Известные ограничения

Некоторые функции Word не имеют эквивалентов Markdown:

• Соединенные ячейки таблицы упрощены до соседних столбцов
• Встроенные изображения экспортируются в папку изображений, когда вы выбираете Markdown + изображения ZIP скачать
• Текстовые окна и SmartArt не поддерживаются
• Персонализированные стили параграфов соответствуют ближайшему стандартному эквиваленту
• Изменения / комментарии трека удаляются (конвертируется только конечный контент)

Когда мамонт обнаруживает элементы, он не может полностью преобразовать их. Панель "Заметки конверсии" в видении результатов перечислит их, чтобы вы могли просмотреть их вручную.