Markdown świetnie nadaje się do pisania, ale odbiorcy dokumentu często oczekują strony internetowej albo pliku PDF. Dobra wiadomość: konwersja Markdown jest prosta i w większości przypadków nie potrzebujesz skomplikowanego zestawu narzędzi.
Poniżej znajdziesz cztery sposoby — od najszybszego do najbardziej konfigurowalnego — oraz zestaw wskazówek, dzięki którym wynik będzie wyglądał profesjonalnie.
Szybkie porównanie
| Metoda | HTML | Instalacja | Najlepsze do | |
|---|---|---|---|---|
| Eksport z edytora w przeglądarce | ✅ | ✅ (druk) | Nic | Codziennych dokumentów, szybkiego udostępniania |
| VS Code + rozszerzenie | ✅ | ✅ | Edytor + rozszerzenie | Osób, które już piszą w VS Code |
| Pandoc | ✅ | ✅ | Pandoc (+ silnik PDF) | Książek, publikacji naukowych, automatyzacji |
| Skrypt (markdown-it, marked) | ✅ | — | Node.js | Własnych stron i procesów budowania |
1. Eksport z edytora w przeglądarce
Najszybsza droga to edytor, który eksportuje bezpośrednio. W Markdown Preview Editor otwórz lub wklej dokument — w wersji online albo we własnej kopii — i użyj przycisków w nagłówku:
- HTML tworzy jeden samodzielny plik
.html. Style, podświetlanie kodu, wzory, diagramy i obrazy otwarte razem z dokumentem są osadzane w pliku, więc wygląda on poprawnie na każdym komputerze i można go bez zmian dołączyć do e-maila lub wgrać w dowolne miejsce. - Drukuj otwiera okno drukowania przeglądarki. Jako drukarkę wybierz Zapisz jako PDF, aby otrzymać plik PDF. Drukowany jest tylko wyrenderowany dokument — bez paska narzędzi i bez edytora.
- Zapisz pobiera źródło Markdown jako plik
.md.
Ponieważ wszystko dzieje się w przeglądarce, sprawdza się to także przy dokumentach, których nie chcesz wysyłać do konwertera online.
Czysty PDF z okna drukowania
- Ustaw Marginesy na Domyślne lub Minimalne, w zależności od tego, ile tekstu ma się zmieścić na stronie.
- Wyłącz Nagłówki i stopki, aby usunąć datę i adres URL z krawędzi strony.
- Włącz Grafikę w tle, jeśli chcesz zachować tło bloków kodu i paski w tabelach.
- Do druku używaj jasnego motywu — oszczędza tusz i łatwiej się go czyta na papierze.
2. VS Code z rozszerzeniem
VS Code ma wbudowany podgląd Markdown, ale nie ma przycisku eksportu. Rozszerzenia takie jak Markdown PDF czy Markdown Preview Enhanced dodają polecenia eksportu do HTML i PDF. To wygodne, jeśli VS Code jest już Twoim edytorem; wygląd wyniku zależy od rozszerzenia, a niektóre z nich przy pierwszym użyciu pobierają przeglądarkę bez interfejsu (headless).
3. Pandoc — uniwersalny konwerter
Pandoc konwertuje między dziesiątkami formatów i jest standardowym narzędziem do książek, publikacji naukowych i automatycznie generowanej dokumentacji. Po instalacji konwersja to jedno polecenie:
bash# Markdown do kompletnej strony HTML
pandoc report.md -o report.html --standalone --metadata title="Report"
# Markdown do PDF (wymaga silnika PDF, np. dystrybucji LaTeX)
pandoc report.md -o report.pdf --pdf-engine=xelatex
# Markdown do Worda, jeśli ktoś nalega
pandoc report.md -o report.docx
Bez --standalone Pandoc zwraca tylko fragment HTML — przydatny, gdy wstawiasz go do istniejącej strony. Eksport do PDF wymaga osobnego silnika: dystrybucji LaTeX albo silnika opartego na HTML, takiego jak WeasyPrint. Siłą Pandoca jest kontrola: szablony, cytowania, numerowane sekcje i odsyłacze.
4. Kilka linijek JavaScriptu
Jeśli Markdown jest częścią Twojej strony lub procesu budowania, najbardziej elastyczna będzie biblioteka. Z markdown-it:
jsimport MarkdownIt from 'markdown-it';
import { readFileSync, writeFileSync } from 'node:fs';
const md = new MarkdownIt({ linkify: true, typographer: true });
const body = md.render(readFileSync('README.md', 'utf8'));
writeFileSync('README.html', `<!doctype html><meta charset="utf-8"><title>README</title>${body}`);
Wtyczki dodają przypisy, listy zadań, wzory i nie tylko. Pamiętaj, że wynik jest tak bezpieczny jak dane wejściowe: jeśli Markdown pochodzi od innych osób, oczyść HTML (na przykład za pomocą DOMPurify) przed publikacją.
Wskazówki dla lepszego HTML i PDF
Zacznij od jednego wyraźnego tytułu
Konwertery biorą tytuł dokumentu z nazwy pliku, pierwszego nagłówka lub jawnie podanych metadanych. Nadaj każdemu dokumentowi opisową nazwę pliku i jeden nagłówek #, a wyeksportowany HTML i PDF łatwo rozpoznasz w folderze pobranych plików czy na karcie przeglądarki.
Trzymaj obrazy obok dokumentu
Używaj ścieżek względnych, takich jak images/chart.png, i trzymaj pliki w tym samym folderze. Gdy otworzysz cały folder w Markdown Preview Editor, obrazy zostaną odnalezione i osadzone w eksporcie HTML. Zdalne obrazy, które nie są wczytane w podglądzie, również nie zostaną osadzone.
Kontroluj podział stron
Markdown nie ma składni podziału strony. W dokumentach do druku zaczynaj duże sekcje nagłówkiem ## i utrzymuj tabele krótkie — przeglądarki unikają dzielenia wierszy tabeli, ale ogromna tabela i tak przejdzie na następną stronę. W narzędziach, które pozwalają na surowy HTML i style w tekście, takich jak Pandoc, możesz wstawić <div style="page-break-after: always"></div>.
Sprawdź wzory i diagramy przed eksportem
W większości narzędzi wzory i diagramy są renderowane przez biblioteki JavaScript. Najpierw sprawdź je w podglądzie — zobacz nasze poradniki o wzorach matematycznych w Markdown i diagramach Mermaid. W eksporcie HTML z Markdown Preview Editor są one zapisywane jako gotowe znaczniki i obrazy, więc wyeksportowany plik nie potrzebuje żadnych skryptów.
Wybierz motyw świadomie
Ciemne eksporty HTML przyjemnie wyglądają na ekranie, ale kiepsko sprawdzają się na papierze. Eksportuj z myślą o nośniku, z którego skorzysta czytelnik.
Najczęściej zadawane pytania
Jak za darmo przekonwertować Markdown do PDF?
Otwórz dokument w podglądzie Markdown, takim jak Markdown Preview Editor, kliknij Drukuj i w oknie drukowania wybierz Zapisz jako PDF. Do automatyzacji lub składu książkowego użyj darmowego narzędzia wiersza poleceń Pandoc.
Jak przekonwertować Markdown do HTML bez instalowania czegokolwiek?
Użyj edytora w przeglądarce z eksportem do HTML. Markdown Preview Editor tworzy samodzielny plik HTML z dołączonymi stylami — bezpośrednio w przeglądarce.
Czy obrazy znajdą się w wyeksportowanym HTML?
Lokalne obrazy otwarte razem z dokumentem są osadzane w pliku HTML, więc działa on samodzielnie. Obrazy pozostające na zdalnych serwerach nie są osadzane.
Czy mogę przekonwertować Markdown do Worda (DOCX)?
Tak, za pomocą Pandoca: pandoc input.md -o output.docx. Możesz też wyeksportować HTML i otworzyć go w Wordzie, który zachowa większość formatowania.