Конвертер DOCX в Markdown
Чтобы перенести документацию из Word в Git-репозиторий, сначала нужно превратить каждый .docx в Markdown. Этот конвертер создает текст в стиле CommonMark с заголовками #, таблицами с вертикальными чертами и ссылками на изображения — его можно сразу коммитить.
Конвертер документов
или перетащите сюда файлы PDF, DOC, DOCX … ·
Макс. 95 MB на файл· До 20 файлов· Удаляются через 30 минут
Файлы обрабатываются на наших серверах и удаляются через 30 минут.
При 150 DPI страница A4 превращается примерно в 1240 × 1754 px. Для печати используйте 300.
Преобразуйте весь файл или только часть страниц либо слайдов (для PDF и презентаций).
Страницы или слайды для преобразования, например 1-3, 5, 8-10.
UTF-8 подходит для любого языка. Выберите «UTF-8 с BOM», если Excel или Блокнот в Windows показывают нечитаемые символы; устаревшие кодировки — только для старых программ.
LF — для macOS, Linux и редакторов кода; CRLF — для старых программ Windows, например классического Блокнота.
Стандарт — запятая. Точку с запятой используйте для Excel в странах, где дробная часть отделяется запятой (Германия, Франция, Бразилия).
Для файлов Excel с несколькими листами: преобразовать все (по разделу или файлу на лист) или только первый.
Как пользоваться инструментом
- 1
Загрузите файлы Word
Добавьте до 20 файлов .docx или .doc, каждый до 95 MB. Сначала примите или отклоните исправления в Word: в Markdown их показать нельзя.
- 2
Проверьте параметры текста
Для параметра Форматирование выбрано «Простое», для Кодировка текста — UTF-8, для Окончания строк — LF: именно это сочетание ожидают Git и генераторы статических сайтов. Оставьте включённым Включить изображения, чтобы картинки сохранялись в отдельной папке.
- 3
Конвертируйте и распакуйте
Нажмите Конвертировать в MD →. Каждый документ придёт в виде ZIP-архива с файлом .md и его изображениями; распакуйте его в папку с документацией и сделайте коммит.
Как перевести документ Word в Markdown?
Загрузите .docx и нажмите Конвертировать в MD →. Вы получите файл .md с заголовками #, списками, ссылками и таблицами, а рядом в папке — изображения, всё в одном ZIP-архиве.
DOCX в Markdown для docs-as-code
Команды переходят на docs-as-code по одной причине: документация лежит рядом с кодом, проходит те же pull request и выходит с тем же релизом. Файл .docx это ломает: он представляет собой ZIP из XML-частей, который Git хранит как непрозрачный двоичный файл. Правка одного слова выглядит как изменённый файл без читаемого различия, а два человека, редактирующие одновременно, не могут слить свою работу.
Markdown — это простой текст, поэтому любая правка видна как изменение строки. Он стал куда предсказуемее в 2014 году, когда Джон Макфарлейн и другие опубликовали CommonMark — точную спецификацию синтаксиса, который Грубер описал свободно десятью годами ранее. В 2017 году GitHub основал свою спецификацию GitHub Flavored Markdown на CommonMark, добавив таблицы с вертикальными чертами, списки задач и зачёркивание, которые сегодня есть в большинстве README.
Если содержимое нужно передать в обратную сторону, из Markdown рецензенту, который работает в Word, используйте Markdown в DOCX. Для веб-страницы, а не репозитория, DOCX в HTML сохраняет больше оформления.
Как выглядит результат в Markdown
## Чек-лист релиза Перед тем как ставить тег релиза, проверьте: - Тесты проходят в **main** - В журнале изменений есть все слитые PR | Шаг | Ответственный | | --- | --- | | Сборка | CI | | Публикация | Мейнтейнер | 
Где будет отображаться полученный Markdown
| Организация | Требование | Источник |
|---|---|---|
| GitHub | Отображает README.md и любой файл .md в репозитории с помощью GitHub Flavored Markdown | github.com |
| Hugo | Строит страницы из файлов содержимого .md парсером, совместимым с CommonMark | gohugo.io |
| Jekyll | Превращает файлы .md с front matter в страницы; движок, на котором работает GitHub Pages | jekyllrb.com |
| Docusaurus | Читает файлы .md и .mdx в папке docs как страницы документации | docusaurus.io |
DOCX
Документ Microsoft Word
DOCX — формат документов Microsoft Word по умолчанию начиная с Office 2007, основанный на стандарте Office Open XML (ECMA-376, ISO/IEC 29500). Это ZIP-пакет XML-файлов, в которых хранятся текст, стили, изображения, таблицы, комментарии и исправления. Это самый распространённый формат редактируемых документов в офисах, учебных заведениях и при отклике на вакансии. Вёрстка может немного сдвигаться между Word, Google Docs, LibreOffice и Pages, особенно при сложном форматировании. Большинство текстовых редакторов открывают файлы DOCX.
- Сжатие
- –
- Прозрачность
- –
- Анимация
- –
- Год появления
- 2007 · Microsoft
MD
Разметка Markdown
Markdown — облегчённый синтаксис разметки, созданный Джоном Грубером в 2004 году. В нём используются обычные текстовые символы — # для заголовков, * для выделения и - для списков, — которые остаются читаемыми в исходном тексте и аккуратно преобразуются в HTML. Это стандарт для файлов README, документации, вики, приложений для заметок и многих генераторов статических сайтов. Существует несколько диалектов, например CommonMark и GitHub Flavored Markdown, которые различаются в деталях вроде таблиц. Файлы .md открываются в любом текстовом редакторе.
- Сжатие
- –
- Прозрачность
- –
- Анимация
- –
- Год появления
- 2004 · John Gruber
DOCX переводят в Markdown, когда документ попадает в процесс разработки: README, сайт с документацией или база знаний в Git, где простой текст можно сравнивать, проверять в pull request и отображать множеством инструментов.
Возможности Word, которым нет аналога в Markdown
Учтите это до конвертации
- Шрифты, цвета и разметка страницы отбрасываются: Markdown описывает структуру, а внешний вид определяет тема сайта
- Исправления и комментарии не переносятся, поэтому сначала разберите их в Word
- Колонтитулы и номера страниц в файле .md не нужны
- Надписи и изображения с обтеканием становятся обычными абзацами и ссылками на изображения
- Заголовки, оформленные вручную (полужирный 16 pt вместо «Заголовок 2»), превращаются в полужирный текст, поэтому сначала примените настоящие стили заголовков
- У подчёркивания нет синтаксиса Markdown, поэтому оно удаляется или сохраняется как HTML
Вопросы о конвертации DOCX в Markdown
Какому диалекту Markdown соответствует результат конвертации DOCX в MD?
Заголовки, выделение, списки, ссылки и код соответствуют CommonMark, а таблицы используют синтаксис с вертикальными чертами из GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll и Docusaurus отображают эту комбинацию.
Что происходит с объединенными ячейками таблиц?
В таблицах Markdown нет объединённых ячеек, поэтому каждая объединённая область разделяется на отдельные ячейки, а текст остаётся в первой. Сложные таблицы пересоберите как HTML внутри .md или упростите в Word перед конвертацией.
Куда попадают картинки из документа Word?
Если включён параметр Включить изображения, каждая картинка сохраняется отдельным файлом в ZIP-архиве, а Markdown ссылается на неё по относительному пути, например images/figure-1.png. При переносе держите эту папку рядом с файлом .md.
Сохраняются ли сноски Word в Markdown?
В CommonMark нет синтаксиса сносок, но в 2021 году GitHub добавил сноски [^1], и их поддерживает большинство генераторов сайтов. Если ваш рендерер их не поддерживает, текст сносок окажется обычными абзацами в конце.
Можно ли так конвертировать Google Документы в Markdown?
Да. В Google Docs выберите Файл > Скачать > Microsoft Word (.docx), затем загрузите этот файл сюда. У Google Docs есть и собственная загрузка в Markdown, которая хорошо подходит для простых документов.
