Konwerter Markdown

Acrafto Team Tekst
Zaktualizowano

Blok front matter na początku nie jest drukowany. Jego tytuł „Raport kwartalny” służy jako tytuł dokumentu.

Wynik
Raport kwartalny

Ten dokument pokazuje, co zachowuje konwerter: nagłówki, listy, tabele, kod, cytaty, linki i przypisy.1

Najważniejsze informacje
  • Przychody wzrosły o 12% w porównaniu z poprzednim kwartałem
  • Do zespołu dołączyły we wrześniu dwie nowe osoby
  • Pełne dane są na stronie projektu
Liczby
Miesiąc Zamówienia Zmiana
Lipiec 1 240 +4%
Sierpień 1 310 +6%
Wrzesień 1 395 +6%
Kolejne kroki
  1. Dokończ przewodnik dla nowych pracowników
  2. Przejrzyj stronę z cennikiem
    • Porównaj ją ze starą wersją
    • Poproś dział wsparcia o opinię
  3. Zaplanuj kolejne wydanie
  • Zbierz dane
  • Wyślij raport

Liczby zaokrąglono do pełnych zamówień.

npm run build && npm run deploy

  1. Tytuł pochodzi z bloku YAML front matter na początku, który nie jest drukowany. ↩︎

Opcje

Ten konwerter Markdown na PDF, Word, HTML i zwykły tekst działa bezpośrednio w Twojej przeglądarce: wklej tekst lub otwórz plik .md, wybierz format i pobierz wynik. Zamienia też tabele Markdown na pliki Excel lub CSV, tworzy e-booki EPUB i dokumenty LaTeX oraz przepisuje Markdown dla Jiry, Confluence, Slacka i forów z BBCode. Podgląd obok tekstu pokazuje wynik na bieżąco, gdy zmieniasz ustawienia. Twoje pliki nie są nigdzie wysyłane, nie trzeba zakładać konta, nie ma znaku wodnego ani limitu stron.

Jak przekonwertować plik Markdown

  1. Wklej Markdown do lewego pola albo kliknij Otwórz pliki i wybierz jeden lub więcej plików .md. Możesz też po prostu upuścić pliki na konwerter.
  2. Wybierz format w sekcji Konwertuj na. Dokumenty to PDF, Word (DOCX), EPUB, LaTeX, HTML i Tekst (TXT), Tabele to Excel (XLSX) i CSV, a Dla aplikacji to Jira / Confluence, Slack i BBCode.
  3. Sprawdź podgląd w sekcji Wynik i w razie potrzeby zmień rozmiar strony, marginesy, czcionkę lub inne ustawienia w sekcji Opcje.
  4. Jeśli chcesz, popraw nazwę w polu Nazwa pliku i kliknij przycisk pobierania. Formaty tekstowe możesz też skopiować prosto do schowka, a dla Jiry, Slacka i BBCode kopiowanie jest głównym przyciskiem.

Konwerter startuje z przykładowym raportem kwartalnym, który ma tytuł w front matter, listy, tabelę z liczbami wyrównanymi do prawej, listę zadań, cytat, blok kodu i przypis. Przekonwertuj go na każdy format, aby zobaczyć, jak wyglądają poszczególne elementy po konwersji.

Konwerter Markdown na PDF

PDF powstaje w Twojej przeglądarce i zawiera prawdziwy tekst, który można zaznaczać, a nie zrzut ekranu strony. Nagłówki pojawiają się jako zakładki w panelu bocznym czytnika PDF, linki pozostają klikalne, a linki do nagłówków lub przypisów przenoszą w obrębie dokumentu. Tabele zachowują wyrównanie kolumn i powtarzają wiersz nagłówka na każdej stronie, na którą się rozciągają, zagnieżdżone listy są numerowane 1., a., i. jak w Wordzie, a listy zadań dostają rysowane pola wyboru. Bloki kodu używają czcionki o stałej szerokości znaków na jasnoszarym tle, więc wcięcia zostają dokładnie takie, jak je zapisano.

W sekcji Opcje ustawisz Rozmiar strony (A4 lub Letter, wstępnie wybrany według języka przeglądarki), Marginesy (wąskie 1,27 cm, normalne 2,54 cm lub szerokie 3,81 cm, czyli 0,5 cala, 1 cal lub 1,5 cala), szeryfową lub bezszeryfową czcionkę w polu Czcionka, Rozmiar czcionki oraz to, czy drukować Numery stron. Spis treści dodaje po tytule listę nagłówków z numerami stron.

Czcionki są osadzone w pliku PDF, więc wygląda tak samo na każdym komputerze i na każdej drukarce. Obejmują alfabet łaciński, cyrylicę, alfabet grecki i wietnamski oraz strzałki, znaki matematyczne i symbole takie jak → ≤ ✓ ★. Nie obejmują pisma chińskiego, japońskiego, koreańskiego, arabskiego, hebrajskiego i tajskiego, pism indyjskich ani emoji. Gdy dokument ich używa, konwerter wymienia te znaki, a przycisk pobierania zmienia się na Zapisz jako PDF: otwiera okno drukowania przeglądarki, które korzysta z czcionek Twojego systemu i zapisuje arabski i hebrajski od prawej do lewej. Jako drukarkę wybierz Zapisz jako PDF, a rozmiar strony, marginesy i czcionka z sekcji Opcje zostaną zachowane.

Konwersja Markdown na Word (DOCX)

Plik Word ma prawdziwą strukturę dokumentu, a nie tylko tekst, który ją udaje. Nagłówki używają wbudowanych stylów od „Nagłówek 1” do „Nagłówek 6”, więc okienko nawigacji w Wordzie je wyświetla, a przycisk Spis treści na karcie Odwołania tworzy stronę ze spisem treści jednym kliknięciem. Listy są prawdziwymi listami Worda, które zachowują numerację, gdy dodajesz pozycje, każda lista numerowana zaczyna się od nowa od 1 (albo od liczby wpisanej w Markdown), a zadania dostają ☐ i ☒. Tabele powtarzają wiersz nagłówka na każdej stronie, przypisy stają się prawdziwymi przypisami Worda na dole strony, a linki do nagłówków do nich przenoszą.

Wybierz rozmiar strony, marginesy, rozmiar czcionki i jedną ze standardowych czcionek: Calibri, Cambria, Arial lub Times New Roman. Word wyświetla plik czcionką zainstalowaną na komputerze, na którym jest otwierany, więc podgląd na tej stronie dobrze oddaje wygląd pliku, ale nie jest jego kopią co do piksela. Plik .docx otworzysz w Microsoft Word, LibreOffice i innych programach, które obsługują format Office Open XML. Aby przenieść Markdown do Google Docs, prześlij plik .docx na Dysk Google i otwórz go w Google Docs albo wklej tekst za pomocą funkcji Kopiuj z formatowaniem w edytorze Markdown.

Markdown na HTML

Pełna strona ze stylami daje samodzielny plik .html z własnym, przejrzystym arkuszem stylów. Działa offline, dopasowuje się do jasnego lub ciemnego motywu systemu czytelnika i dobrze się drukuje. Tylko treść, do CMS daje same elementy HTML (<h2>, <p>, <ul>, <table> i tak dalej) bez żadnych stylów, gotowe do wklejenia do WordPressa, Ghosta, narzędzia do newsletterów albo własnego szablonu. Przełączaj podgląd między widokami Widok strony a Kod, aby zobaczyć obie wersje.

HTML jest zgodny z CommonMark i GitHub Flavored Markdown (obie strony po angielsku). Nagłówki dostają atrybuty id jak na GitHubie, więc linki typu #plan-wydania nadal działają, a przypisy mają linki powrotne do miejsc, w których je przywołano. Skrypty, procedury obsługi zdarzeń i linki javascript: są usuwane z surowego HTML w źródle, więc plik Markdown od kogoś innego nie przemyci kodu na Twoją stronę.

Markdown na zwykły tekst

Tekst (TXT) usuwa składnię Markdown i zachowuje czytelną strukturę: punktory stają się „- ”, numerowane pozycje zachowują numery, zadania wyglądają jak [ ] i [x], cytaty zaczynają się od „> ”, tabele są wyrównane w kolumnach, a przypisy są wypisane na końcu jako [1], [2]. Zachowaj adresy linków wpisuje URL w nawiasie po każdym linku, więc nic nie ginie, gdy tekst trafia do e-maila, pola formularza lub systemu, który nie rozumie Markdown. Długość linii pozwala zawijać długie wiersze po 72 lub 80 znakach na potrzeby e-maili w zwykłym tekście.

Przydaje się to także przy odpowiedziach z czatów AI, które przychodzą w Markdown: konwersja na tekst usuwa gwiazdki i krzyżyki, zanim wkleisz odpowiedź w inne miejsce.

Tabele Markdown do Excela i CSV

Excel (XLSX) i CSV wyciągają z dokumentu tylko tabele, co przydaje się przy tabelach w plikach README, dokumentacji albo odpowiedziach z czatów AI. W Excelu każda tabela trafia do osobnego arkusza nazwanego tak jak nagłówek nad nią. Liczby są zapisywane jako prawdziwe liczby, także te ze spacją jako separatorem tysięcy, takie jak 1 240, oraz procenty, takie jak 12%, więc od razu możesz je sumować i sortować, a wartości takie jak 007 czy kod pocztowy zachowują zera wiodące jako tekst. Wiersz nagłówka jest pogrubiony i zablokowany, a każdy arkusz dostaje filtr.

CSV zapisuje jeden plik na tabelę, a kilka tabel trafia do archiwum ZIP. W sekcji Opcje wybierasz Separator: Excel ustawiony na język z przecinkiem dziesiętnym, taki jak polski, niemiecki czy francuski, oczekuje średnika, w przeciwnym razie cały wiersz trafi do jednej kolumny. Zgodny z Excelem (UTF-8 z BOM) sprawia, że Excel poprawnie odczytuje polskie litery i inne znaki diakrytyczne. Kopiuj tabele umieszcza tabele w schowku, więc wkleisz je do Excela lub Arkuszy Google bez zapisywania pliku.

Markdown dla Jiry, Confluence, Slacka i BBCode

Te trzy formaty to tekst dla aplikacji, które nie odczytują standardowego Markdown, więc główny przycisk kopiuje wynik:

  • Jira / Confluence zapisuje znaczniki wiki: nagłówki h2., *bold*, _italic_, bloki {code}, tabele ||header||, linki [text|url] oraz listy # lub *. Format jest przeznaczony dla Jiry i Confluence w wersji Data Center lub Server oraz dla starszych pól, które nadal używają znaczników wiki. Obecny edytor w Jira Cloud sam odczytuje Markdown, więc tam możesz wkleić oryginalny tekst.
  • Slack zapisuje własne znaczniki Slacka: *bold*, _italic_, ~strikethrough~, kod, cytaty i linki [text](url), a listy zamienia na znaki punktorów, tabele zaś na wyrównane bloki kodu, bo Slack nie ma tabel. Aby zobaczyć formatowanie po wysłaniu, włącz w Slacku opcję Format messages with markup w ustawieniach Preferences, Advanced. Dla botów i webhooków (format API) zapisuje linki jako <url|text> i koduje znaki &, < i >, tak jak wymaga tego API Slacka.
  • BBCode używa tagów, które rozumieją phpBB, vBulletin, XenForo, SMF i MyBB: [b], [i], [u], [s], [url], [img], [quote], [list] i [code]. Nagłówki stają się pogrubionymi wierszami, bo rozmiary nagłówków różnią się między forami, a tabele zamieniają się w wyrównane bloki [code].

Markdown na EPUB dla czytników e-booków i Kindle

EPUB tworzy e-book ze stroną tytułową, spisem treści i osobnym rozdziałem dla każdego nagłówka najwyższego poziomu. Gdy dokument ma jeden nagłówek 1 użyty jako tytuł, rozdziały zaczynają się zamiast tego od nagłówków 2; ustawisz to opcją Podział na rozdziały w sekcji Opcje. Przypisy są zbierane jako przypisy końcowe z linkami powrotnymi do tekstu, obrazy z adresem internetowym są osadzane, a tytuł i autor z front matter pojawiają się w informacjach o książce.

Pliki przechodzą walidację EPUBCheck (po angielsku), oficjalnego walidatora EPUB, więc otwierają się w Apple Books, Kobo, Książkach Google Play i Calibre. Usługa Send to Kindle od Amazona również przyjmuje pliki EPUB i konwertuje je na Twój czytnik Kindle, a Kindle Direct Publishing przyjmuje rękopisy w formacie EPUB, z okładką przesyłaną osobno.

Markdown na LaTeX

LaTeX tworzy kompletny dokument article, który wczytuje tylko potrzebne pakiety, albo z opcją Tylko treść, do wklejenia w dokument samą treść do dokumentu, który już masz, na przykład w Overleaf. Nagłówki stają się poleceniami \section i \subsection, listy środowiskami itemize i enumerate, tabele środowiskiem tabular z zachowanym wyrównaniem kolumn, kod trafia do verbatim, przypisy stają się prawdziwymi poleceniami \footnote, a linki używają \href. Znaki, które LaTeX traktuje jako polecenia, takie jak %, $, &, # i _, są odpowiednio poprzedzane ukośnikiem wstecznym. LaTeX nie potrafi wczytywać obrazów z internetu, więc każdy obraz staje się wierszem \includegraphics z nazwą pliku i oryginalnym adresem w komentarzu; pobierz obraz i zapisz go obok pliku .tex. Kompiluj za pomocą pdfLaTeX, a dla pism innych niż łacińskie za pomocą XeLaTeX lub LuaLaTeX.

Konwersja kilku plików .md naraz

Otwórz lub upuść kilka plików, a pod polem tekstowym pojawi się lista. Edytuj wczytuje plik do pola, żeby można go było sprawdzić lub poprawić, Usuń wyjmuje go z listy, a Pobierz wszystko jako ZIP konwertuje każdy plik do wybranego formatu z tymi samymi ustawieniami. Każdy plik zachowuje swoją nazwę, więc z notes.md powstaje notes.pdf. Pliki, które nie są tekstem, na przykład obrazy, są pomijane z odpowiednim komunikatem.

Front matter, obrazy i nazwy plików

Wiele plików Markdown zaczyna się blokiem YAML front matter (po angielsku) między dwoma wierszami ---, którego używają Jekyll, Hugo, Obsidian i inne narzędzia. Konwerter go nie drukuje. Jego title staje się tytułem dokumentu we właściwościach PDF i Worda oraz w znaczniku HTML <title>, a także proponowaną nazwą pliku; author staje się autorem. Bez front matter nazwę plikowi daje pierwszy nagłówek najwyższego poziomu.

Obrazy z pełnym adresem internetowym są pobierane przez Twoją przeglądarkę i osadzane w pliku PDF i Word, o ile serwer, na którym się znajdują, na to pozwala (CORS, po angielsku). Obrazy GIF, WebP i SVG są po drodze konwertowane na PNG.

Często zadawane pytania

Czy moje pliki Markdown są wysyłane na serwer?

Nie. Odczyt plików, tworzenie dokumentów PDF i Word oraz pakowanie archiwum ZIP odbywają się w Twojej przeglądarce, więc prywatne notatki i wewnętrzna dokumentacja nigdy nie opuszczają Twojego komputera. Konwerter zapamiętuje tylko ustawienia, takie jak format i rozmiar strony, a nie tekst.

Dlaczego w moim pliku PDF brakuje obrazów?

Obrazów zapisanych jako ścieżka na Twoim komputerze, na przykład images/chart.png, strona internetowa nie może odczytać, więc zastępuje je ich opis. Użyj pełnego adresu https albo najpierw umieść obraz w internecie. Niektóre witryny blokują też wczytywanie swoich obrazów przez inne strony; wtedy również używany jest opis, a konwerter informuje, ilu obrazów nie udało się wczytać.

Czy mogę przekonwertować Markdown z tekstem po chińsku, japońsku lub arabsku na PDF?

Tak, przez przeglądarkę. Czcionki wbudowane w PDF nie zawierają tych pism, więc przy takim dokumencie przycisk pobierania zmienia się na Zapisz jako PDF i otwiera okno drukowania, w którym jako drukarkę wybierasz Zapisz jako PDF. Przeglądarka używa czcionek Twojego systemu, tekst da się zaznaczać, a arabski i hebrajski biegną od prawej do lewej. Word (DOCX) i HTML również zachowują każdy znak.

Czy obsługiwane są wzory matematyczne LaTeX lub diagramy Mermaid?

Nie. Wzory zapisane między znakami dolara pozostają zwykłym tekstem, a blok Mermaid jest konwertowany jak każdy inny blok kodu. Tabele, listy zadań, przypisy, kod i cała reszta GitHub Flavored Markdown są obsługiwane w każdym formacie.

Czy mogę zamienić dokument Word lub Google Docs na Markdown?

Tak, za pomocą edytora Markdown: wklej tekst skopiowany z Worda, Google Docs lub strony internetowej, a jego formatowanie zamieni się w Markdown, łącznie z nagłówkami, listami, linkami i tabelami. Konwersja pliku PDF z powrotem na Markdown nie jest obsługiwana, bo PDF przechowuje tekst rozmieszczony na stronie, a nie nagłówki, listy i tabele.

Jak przekonwertować tabelę Markdown do Excela?

Wklej Markdown z tabelą, wybierz Excel (XLSX) i pobierz plik. Każda tabela staje się arkuszem, w którym liczby są zapisane jako liczby. Jeśli potrzebujesz tylko wartości w arkuszu, który masz już otwarty, kliknij Kopiuj tabele i wklej je do Excela lub Arkuszy Google.

Dlaczego Excel wstawia cały wiersz CSV do jednej kolumny?

Excel dzieli plik CSV według separatora listy ustawionego w systemie. W językach, w których części dziesiętne oddziela się przecinkiem, takich jak polski, niemiecki, francuski czy czeski, tym separatorem jest średnik. Wybierz Średnik w polu Separator i pobierz plik ponownie. Jeśli polskie litery wyświetlają się nieprawidłowo, pozostaw włączoną opcję Zgodny z Excelem (UTF-8 z BOM).

Czy mogę wysłać plik EPUB na czytnik Kindle?

Tak. Usługa Send to Kindle od Amazona, dostępna przez e-mail, w aplikacji Kindle i na stronie Send to Kindle, przyjmuje pliki EPUB i konwertuje je do biblioteki Kindle. Kindle Direct Publishing również przyjmuje EPUB, jeśli chcesz wydać książkę.

Czy Jira Cloud nadal używa znaczników wiki?

Nie w obecnym edytorze, który odczytuje Markdown i zamienia go na formatowanie podczas wklejania lub pisania. Format Jira / Confluence jest przeznaczony dla Jiry i Confluence w wersji Data Center lub Server oraz dla starszych pól, które nadal wyświetlają znaczniki wiki. W Jira Cloud możesz zamiast tego wkleić oryginalny Markdown.

Czy mogę otworzyć plik LaTeX w Overleaf?

Tak. Utwórz nowy pusty projekt, prześlij plik .tex lub wklej jego zawartość, a potem prześlij obrazy, do których się odwołuje. Z opcją Tylko treść, do wklejenia w dokument dostajesz samą treść do projektu, który ma już własną preambułę.

Jak przekonwertować Markdown na PDF lub Word z wiersza poleceń?

Typowym narzędziem jest Pandoc (po angielsku): pandoc notes.md -o notes.docx od razu tworzy plik Word, a do wyniku w PDF trzeba dodatkowo zainstalować silnik LaTeX. Ta strona nie wymaga instalacji i najpierw pokazuje podgląd, co jest wygodniejsze przy pojedynczym dokumencie albo niewielkiej partii plików.

Czy jest limit rozmiaru pliku lub liczby stron?

Każdy plik może mieć do 20 MB tekstu, czyli znacznie więcej niż jakikolwiek zwykły dokument, i nie ma limitu stron ani znaku wodnego. Tworzenie bardzo długich dokumentów z wieloma obrazami trwa kilka sekund, bo całą pracę wykonuje Twój własny komputer.

Aby najpierw napisać lub poprawić Markdown, użyj edytora Markdown z podglądem na żywo; jego przycisk Więcej opcji eksportu otwiera ten konwerter z wpisanym już tekstem. Więcej narzędzi do pracy z tekstem znajdziesz w kategorii Tekst, na przykład licznik słów i znaków i narzędzie do porównania dwóch tekstów.

Byłbym wdzięczny, gdybyś udostępnił te strony znajomym, dodał je do zakładek lub linkował do nich. Dziękuję! 🙏