Конвертер DOCX у Markdown
Щоб перенести документацію з Word у Git-репозиторій, спершу потрібно перетворити кожен .docx на Markdown. Цей конвертер створює текст у стилі CommonMark із заголовками #, таблицями з вертикальними рисками та посиланнями на зображення, і його можна одразу закомітити.
Конвертер документів
або перетягніть Файли PDF, DOC, DOCX … сюди ·
До 95 МБ на файл· До 20 файлів· Видаляються через 30 хв
Файли обробляються на наших серверах і видаляються через 30 хв.
150 DPI перетворює сторінку A4 приблизно на 1240 × 1754 px. Для друку використовуйте 300.
Перетворити весь файл або лише частину сторінок чи слайдів (для PDF і презентацій).
Сторінки або слайди для перетворення, наприклад 1-3, 5, 8-10.
UTF-8 підходить для всіх мов. Виберіть UTF-8 with 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 зберігає як непрозорий бінарний файл. Зміна одного слова виглядає як змінений файл без читабельного diff, а двоє людей, що редагують одночасно, не можуть злити свої правки.
Markdown є простим текстом, тож кожна правка — це видима зміна рядка. Він також став набагато передбачуванішим у 2014 році, коли Джон Макфарлейн та інші опублікували CommonMark, точну специфікацію синтаксису, який Грубер описав доволі вільно десятьма роками раніше. У 2017 році GitHub створив власну специфікацію GitHub Flavored Markdown на основі CommonMark, додавши таблиці з вертикальними рисками, списки завдань і закреслення, які використовує більшість README.
Якщо вміст рухається в протилежний бік, із Markdown до рецензента, який працює у Word, скористайтеся Markdown у DOCX. Для вебсторінки, а не репозиторію, DOCX у HTML зберігає більше стилів.
Як виглядає результат у Markdown
## Чекліст релізу Перш ніж ставити тег релізу, перевірте: - Тести проходять на **main** - Changelog містить кожен змерджений 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 немає синтаксису для виносок, але GitHub додав виноски [^1] у 2021 році, і більшість генераторів сайтів їх підтримують. Якщо ваш рендерер їх не підтримує, текст виноски з’явиться звичайними абзацами в кінці.
Чи можна так конвертувати Google Docs у Markdown?
Так. У Google Docs виберіть Файл > Завантажити > Microsoft Word (.docx), а потім завантажте цей файл сюди. Google Docs також має власний варіант завантаження у Markdown, який добре підходить для простих документів.
