Konwerter DOCX na Markdown
Przeniesienie dokumentacji z Worda do repozytorium Git zaczyna się od zamiany każdego pliku .docx na Markdown. Ten konwerter tworzy tekst w stylu CommonMark z nagłówkami #, tabelami z kreskami pionowymi i odnośnikami do obrazów, gotowy do commita.
Konwerter dokumentów
lub upuść Pliki PDF, DOC, DOCX … tutaj ·
Maks. 95 MB na plik· Do 20 plików· Usuwane po 30 min
Pliki są przetwarzane na naszych serwerach i usuwane po 30 min.
150 DPI zamienia stronę A4 na około 1240 × 1754 px. Do druku użyj 300.
Przekonwertuj cały plik lub tylko wybrane strony albo slajdy (dla plików PDF i prezentacji).
Strony lub slajdy do konwersji, np. 1-3, 5, 8-10.
UTF-8 obsługuje wszystkie języki. Wybierz UTF-8 z BOM, jeśli Excel lub Notatnik w Windows pokazuje nieprawidłowe znaki; starsze kodowania tylko dla starego oprogramowania.
LF dla macOS, Linuksa i edytorów kodu; CRLF dla starszych programów Windows, takich jak klasyczny Notatnik.
Standardem jest przecinek. Użyj średnika dla Excela w krajach, gdzie część dziesiętną zapisuje się po przecinku (Niemcy, Francja, Brazylia, Polska).
Plik Excel z kilkoma arkuszami: przekonwertuj wszystkie (jedna sekcja lub plik na arkusz) albo tylko pierwszy.
Jak korzystać z narzędzia
- 1
Prześlij pliki Worda
Dodaj do 20 plików .docx lub .doc, każdy do 95 MB. Najpierw zaakceptuj lub odrzuć śledzone zmiany w Wordzie, ponieważ Markdown nie potrafi ich pokazać.
- 2
Sprawdź opcje tekstu
Opcja Formatowanie jest ustawiona na Simple, Kodowanie tekstu na UTF-8, a Znaki końca wiersza na LF – to zestaw, którego oczekują Git i generatory stron statycznych. Zostaw włączone Dołącz obrazy, aby dostać obrazy w osobnym folderze.
- 3
Konwertuj i rozpakuj
Kliknij Konwertuj na MD. Każdy dokument otrzymasz jako ZIP z plikiem .md i jego obrazami; rozpakuj go w folderze z dokumentacją i zatwierdź zmiany w repozytorium.
Jak przekonwertować dokument Word na Markdown?
Prześlij plik .docx i kliknij Konwertuj na MD. Otrzymasz plik .md z nagłówkami #, listami, linkami i tabelami oraz obrazami w folderze obok, a wszystko w jednym archiwum ZIP.
DOCX na Markdown w podejściu docs-as-code
Zespoły wybierają docs-as-code z jednego powodu: dokumentacja leży wtedy obok kodu, przechodzi te same pull requesty i trafia do tego samego wydania. Plik .docx to psuje, ponieważ jest archiwum ZIP z częściami XML, które Git przechowuje jako nieczytelny plik binarny. Zmiana jednego słowa wygląda jak zmiana całego pliku bez czytelnego porównania, a dwie osoby edytujące jednocześnie nie mogą scalić swojej pracy.
Markdown to zwykły tekst, więc każda edycja jest widoczną zmianą wiersza. Stał się też znacznie bardziej przewidywalny w 2014 roku, gdy John MacFarlane i inni opublikowali CommonMark, precyzyjną specyfikację składni, którą Gruber opisał luźno dziesięć lat wcześniej. GitHub oparł w 2017 roku swoją specyfikację GitHub Flavored Markdown na CommonMark, dodając tabele z kreskami pionowymi, listy zadań i przekreślenie, których używa dziś większość plików README.
Jeśli treść ma iść w drugą stronę, czyli z Markdown do recenzenta pracującego w Wordzie, użyj Markdown do DOCX. Dla strony internetowej zamiast repozytorium DOCX do HTML zachowuje więcej stylów.
Jak wygląda wynikowy Markdown
## Lista kontrolna wydania Przed otagowaniem wydania sprawdź, czy: - testy przechodzą na **main** - dziennik zmian wymienia każdy scalony PR | Krok | Odpowiedzialny | | --- | --- | | Kompilacja | CI | | Publikacja | Opiekun | 
Gdzie wyświetli się przekonwertowany Markdown
| Organizacja | Wymaganie | Źródło |
|---|---|---|
| GitHub | Wyświetla README.md i każdy plik .md w repozytorium, używając GitHub Flavored Markdown | github.com |
| Hugo | Buduje strony z plików treści .md za pomocą parsera zgodnego z CommonMark | gohugo.io |
| Jekyll | Zamienia pliki .md z front matter w strony; silnik stojący za GitHub Pages | jekyllrb.com |
| Docusaurus | Odczytuje pliki .md i .mdx z folderu docs jako strony dokumentacji | docusaurus.io |
DOCX
Dokument Microsoft Word
DOCX to domyślny format dokumentów Microsoft Word od Office 2007, oparty na standardzie Office Open XML (ECMA-376, ISO/IEC 29500). Jest to pakiet ZIP z plikami XML zawierającymi tekst, style, obrazy, tabele, komentarze i śledzone zmiany. To najpopularniejszy format edytowalnych dokumentów w biurach, szkołach i przy aplikowaniu o pracę. Układ strony może się nieco różnić między Wordem, Dokumentami Google, LibreOffice i Pages, zwłaszcza przy złożonym formatowaniu. Większość edytorów tekstu otwiera pliki DOCX.
- Kompresja
- –
- Przezroczystość
- –
- Animacja
- –
- Rok powstania
- 2007 · Microsoft
MD
Markdown
Markdown to lekka składnia znaczników stworzona przez Johna Grubera w 2004 roku. Używa symboli tekstu zwykłego, takich jak # dla nagłówków, * dla wyróżnień i - dla list, które pozostają czytelne jako surowy tekst i czysto konwertują się do HTML. Jest standardem w plikach README, dokumentacji, wiki, aplikacjach do notatek i wielu generatorach stron statycznych. Istnieje kilka dialektów, np. CommonMark i GitHub Flavored Markdown, które różnią się szczegółami, jak tabele. Pliki .md otworzy każdy edytor tekstu.
- Kompresja
- –
- Przezroczystość
- –
- Animacja
- –
- Rok powstania
- 2004 · John Gruber
DOCX konwertuje się na Markdown, gdy dokument trafia do procesu pracy z kodem: README, strony z dokumentacją lub bazy wiedzy trzymanej w Git, gdzie zwykły tekst można porównywać, recenzować w pull requestach i renderować w wielu narzędziach.
Funkcje Worda bez odpowiednika w Markdown
Zaplanuj to przed konwersją
- Czcionki, kolory i układ strony są pomijane; Markdown opisuje strukturę, a wygląd wyznacza motyw strony
- Śledzone zmiany i komentarze nie są przenoszone, więc rozstrzygnij je najpierw w Wordzie
- Nagłówki, stopki i numery stron nie mają miejsca w pliku .md
- Pola tekstowe i obrazy z obtekaniem stają się zwykłymi akapitami i linkami do obrazów
- Nagłówki sformatowane ręcznie, pogrubioną czcionką 16 pkt zamiast stylu Nagłówek 2, trafią do pliku jako pogrubiony tekst, więc najpierw zastosuj prawdziwe style nagłówków
- Podkreślenie nie ma składni w Markdown i jest usuwane lub zachowywane jako HTML
Pytania o konwersję DOCX na Markdown
Którą odmianę Markdown stosuje konwersja DOCX na MD?
Nagłówki, wyróżnienia, listy, linki i kod są zgodne z CommonMark, a tabele używają składni z kreskami pionowymi z GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll i Docusaurus wyświetlają taki zapis poprawnie.
Co dzieje się ze scalonymi komórkami tabeli?
Tabele Markdown z kreskami pionowymi nie mają scalonych komórek, więc każdy scalony obszar jest rozdzielany z powrotem na pojedyncze komórki, a tekst trafia do pierwszej z nich. Złożone tabele odtwórz jako HTML wewnątrz pliku .md albo uprość je w Wordzie przed konwersją.
Gdzie trafiają zdjęcia z mojego dokumentu Word?
Gdy Dołącz obrazy jest włączone, każdy obraz jest zapisywany jako osobny plik w archiwum ZIP, a Markdown odwołuje się do niego ścieżką względną, np. images/figure-1.png. Przenosząc plik .md, trzymaj ten folder obok niego.
Czy przypisy z Worda zachowują się w Markdown?
CommonMark nie ma składni przypisów, ale GitHub dodał przypisy [^1] w 2021 roku i obsługuje je większość generatorów stron. Jeśli Twój renderer ich nie obsługuje, treść przypisów pojawi się na końcu jako zwykłe akapity.
Czy w ten sposób mogę zamienić Dokumenty Google na Markdown?
Tak. W Dokumentach Google wybierz Plik > Pobierz > Microsoft Word (.docx), a następnie prześlij ten plik tutaj. Dokumenty Google mają też własną opcję pobierania w Markdown, która dobrze sprawdza się przy prostych dokumentach.
