Markdown na PDF
Wklej Markdown lub upuść plik .md. Zgodny z GitHub-Flavored Markdown. W 100% w Twojej przeglądarce: nic nie jest przesyłane.
Upuść plik .md lub .markdown
lub kliknij, aby wybrać — jest odczytywany tylko w Twojej przeglądarce
Idealne dla technicznych plików README i notatek. Tabele są spłaszczane, a obrazy zewnętrzne pomijane ze względu na prywatność.
Your file is ready
Processed entirely in your browser — the file never left your device.
Jak przekonwertować Markdown na PDF
Trzy kroki. Wszystko dzieje się w Twojej przeglądarce.
Wklej lub upuść
Wklej swój markdown w pole tekstowe lub upuść plik .md. Podgląd na żywo pokazuje, jak będzie wyglądał wynik.
Wybierz opcje
Rozmiar strony, orientacja, rozmiar czcionki tekstu oraz styl bloków kodu. Ustawienia domyślne sprawdzają się w większości plików README.
Utwórz i pobierz
marked parsuje do HTML, HTML jest tokenizowany na bloki, a pdf-lib je rozkłada — wszystko w Twojej karcie.
Dlaczego warto używać Markdown na PDF w imisspdf?
Źródło zostaje na Twoim urządzeniu
Markdown często zawiera wewnętrzne notatki, szkice wpisów lub klucze API w blokach kodu. Nic nie jest przesyłane — każdy bajt procesu jest przetwarzany lokalnie.
Szybko dla dokumentów technicznych
Nagłówki, listy i kod w ogrodzeniu renderują się czytelnie od razu. Bez okna drukowania, bez przechwytywania z Chrome — wklej, kliknij i pobierz.
Zgodny z GFM
Przekreślenia, listy zadań, bloki kodu w ogrodzeniu, autolinki — parserem jest marked w trybie GFM. Tabele są spłaszczane (mówimy o tym z góry).
Co tutaj oznacza „Markdown na PDF”
Markdown to format, w którym większość programistów i autorów technicznych naprawdę tworzy — pliki README, szkice wpisów na bloga, runbooki, dokumentacja API, wewnętrzne wiki. Jest lekki, łatwy do wersjonowania i renderuje się czytelnie w GitHubie. Ale gdy nadchodzi moment, by udostępnić ten dokument komuś, kto nie pracuje w Twoim repozytorium, PDF jest zwykle właściwym formatem dostarczania: drukuje się przewidywalnie, otwiera na każdym urządzeniu i nie zależy od tego, czy odbiorca ma zainstalowaną przeglądarkę markdownu.
Narzędzie Markdown na PDF od imisspdf bierze źródło markdown, które wklejasz (lub upuszczasz jako plik .md) i tworzy pojedynczy PDF w Twojej przeglądarce. Nagłówki zachowują swoją hierarchię, listy utrzymują wcięcia, bloki kodu w ogrodzeniu renderują się czcionką o stałej szerokości, a cytaty / linie poziome wyglądają jak cytaty i linie. Wynikiem jest czysty PDF bez zbędnych ozdobników, odpowiedni dla pliku README, raportu technicznego lub dziennika zmian dostarczanego czytelnikowi nietechnicznemu.
Jak działa konwersja
Trzy etapy wykonują się od początku do końca w Twojej karcie:
- Parser marked konwertuje Twój markdown na HTML z włączonymi regułami GFM (kod w ogrodzeniu, przekreślenia, listy zadań, autolinki).
- Mały tokenizer oparty na wyrażeniach regularnych przechodzi przez HTML i konwertuje go w płaską sekwencję tokenów blokowych — nagłówki, akapity, listy, bloki kodu, cytaty — oraz ich fragmenty wewnątrzwierszowe (pogrubienie, kursywa, kod wewnątrzwierszowy, linki).
- pdf-lib rozkłada bloki na stronach, używając 14 standardowych czcionek PDF (Helvetica dla tekstu, Courier dla kodu). Nowe strony są dodawane w miarę przepełniania się treści.
Nic w tym procesie nie komunikuje się z serwerem. Nie ma markdownu renderowanego zdalnie, nie ma uruchamiającego się w funkcji chmurowej bezgłowego Chromium, nie ma tymczasowego pliku przechowywanego „przez godzinę w celu zachowania retencji”. PDF jest budowany z bajtów JavaScriptu, których możesz zobaczyć zapis w swoich narzędziach deweloperskich.
Kiedy to właściwe narzędzie — a kiedy nie
To narzędzie jest właściwe, gdy potrzebujesz czystego, nadającego się do archiwizacji PDF z treści technicznej: pliku README, runbooka, raportu napisanego w markdownie, notatek ze spotkania, samouczka. Obsługuje formatowanie wewnątrzwierszowe, listy, kod i cytaty dokładnie tak, jak byś tego oczekiwał dla tego typu dokumentu.
To niewłaściwe narzędzie, gdy potrzebujesz wierności co do piksela względem wyrenderowanej witryny (użyj opcji Zapisz jako PDF w przeglądarce na wyrenderowanej stronie), gdy potrzebujesz tabel klasy typograficznej (użyj Pandoc + LaTeX lokalnie) lub gdy potrzebujesz kodu z podświetloną składnią (wyeksportuj z edytora jako HTML i użyj HTML na PDF). Nazywamy ograniczenia z góry, abyś wybrał właściwy sposób postępowania.
Prywatność i bezpieczeństwo
Markdown to jeden z formatów, które najprawdopodobniej zawierają rzeczy, których nie chciałbyś mieć na serwerze: klucze API w blokach kodu, wewnętrzne adresy URL w linkach, szkice wpisów, których jeszcze nie opublikowałeś, nazwy klientów w notatkach ze spotkań. Serwerowe narzędzia markdown-na-PDF muszą wchłonąć to wszystko. Architektura tego narzędzia oznacza, że nie musisz ufać polityce prywatności — po prostu nie ma w procesie kroku przesyłania. Zablokuj swoją sieć, a konwersja nadal będzie działać po wczytaniu strony.
Najczęściej zadawane pytania
Tak — parser działa w trybie GFM, więc bloki kodu w ogrodzeniu (z odwrotnymi apostrofami ```), przekreślenia (~~tekst~~), listy zadań, autolinki oraz złagodzone reguły akapitów GFM — wszystko to działa. Konwersji nie przetrwają jedynie tabele: marked tworzy element HTML <table>, ale renderer PDF w tym narzędziu nie rysuje komórek tabeli, więc tabela wyjdzie jako spłaszczone wiersze tekstu. Jeśli Twój README opiera się w dużej mierze na tabelach, wyrenderuj stronę najpierw w GitHubie, a następnie użyj narzędzia HTML na PDF lub zrób zrzut ekranu, aby uzyskać prawdziwą siatkę.
Nie. Bloki kodu są renderowane czcionką Courier o stałej szerokości w jednym kolorze, dzięki czemu wcięcia i struktura kodu pozostają czytelne, ale tokeny nie są kolorowane według języka. Celowo pomijamy podświetlanie składni, ponieważ wymusiłoby to wczytanie biblioteki podświetlania o rozmiarze ponad 200 KB na stronie, której głównym zadaniem jest konwersja do PDF — a pliki PDF są zwykle drukowane lub archiwizowane, a nie czytane jak w IDE. Jeśli zależy Ci na kolorowym kodzie, wklej podświetlony kod HTML ze swojego edytora przez nasze narzędzie HTML na PDF.
Znaczniki obrazów zewnętrznych () są pomijane — narzędzie nie pobiera zdalnych obrazów. Jest to celowe z dwóch powodów: prywatność (pobranie ujawniłoby Twój adres IP i nagłówek referer hostowi obrazu) oraz niezawodność (renderowanie zależne od sieci oznacza niespójny wynik). Jeśli potrzebujesz obrazów osadzonych w PDF, użyj narzędzi JPG na PDF lub PNG na PDF, aby dodać je jako osobne strony, albo połącz je z plikiem PDF wyrenderowanym z markdownu za pomocą funkcji Połącz PDF.
Nie. Zarówno źródło markdown, jak i wyrenderowany PDF pozostają w całości wewnątrz karty Twojej przeglądarki. Parser marked, tokenizer HTML-na-bloki oraz pdf-lib to JavaScript działający po stronie klienta, wczytywany raz na tej stronie, a następnie uruchamiany lokalnie. Możesz to potwierdzić w karcie Sieć w narzędziach deweloperskich przeglądarki — po wczytaniu strony wygenerowanie PDF nie wysyła żadnych żądań sieciowych. Zamknij kartę i każdy ślad znika; nie ma żadnego tymczasowego pliku po stronie serwera, bo nie ma żadnego kroku serwerowego.
Wszystkie sześć poziomów nagłówków markdown (od # do ######) renderuje się jako nagłówki PDF o malejących rozmiarach (h1 jest największy, h6 jest ledwie większy od tekstu podstawowego). Hierarchia jest zachowana, więc czytniki ekranu i czytniki PDF rozpoznają strukturę dokumentu. Wewnątrz nagłówków honorowane jest formatowanie wewnątrzwierszowe (pogrubienie, kursywa, kod wewnątrzwierszowy). Nie generujemy automatycznie spisu treści — jeśli Twój dokument go potrzebuje, dodaj sekcję "## Spis treści" samodzielnie za pomocą prostej listy markdown.
Nie w postaci siatki. marked poprawnie parsuje tabelę do HTML, ale nasz renderer PDF jest celowo prosty i nie rysuje obramowań komórek ani nie rozkłada kolumn. Tabela wyjdzie jako sekwencja wierszy tekstu, wiersz po wierszu, co zwykle jest nieczytelne dla czegokolwiek bardziej rozbudowanego niż przykład 2x2. Jeśli tabele są niezbędne w Twoim dokumencie, uczciwy sposób postępowania to: wyrenderuj do HTML w ulubionym podglądzie, zrób zrzut ekranu i użyj JPG na PDF — albo skorzystaj lokalnie z Pandoc, aby uzyskać wynik klasy LaTeX. Mówimy o tym ograniczeniu wprost, zamiast udawać, że renderujemy tabele kiepsko.
Wskazówki, jak uzyskać dobry wynik
- Używaj prawdziwych nagłówków.
#na początku wiersza zamienia się w h1; niższe poziomy zagnieżdżają się czytelnie. Czytniki PDF i czytniki ekranu rozpoznają strukturę. - Zachowaj bloki kodu w ogrodzeniu. Bloki z potrójnym odwrotnym apostrofem renderują się w Courier, dzięki czemu wcięcia są czytelne nawet po zawinięciu wiersza.
- Unikaj markdownu z dużą liczbą obrazów. Obrazy zewnętrzne nie są pobierane. Przekonwertuj obrazy na PDF osobno i połącz je.
- W przypadku tabel wyrenderuj markdown najpierw w swoim narzędziu, a następnie zrób zrzut ekranu. Albo użyj Pandoc lokalnie dla tabel klasy typograficznej.
Powiązane narzędzia PDF
- HTML na PDF — ten sam renderer, z danymi wejściowymi HTML zamiast markdownu.
- TXT na PDF — zwykły tekst bez żadnego formatowania.
- Połącz PDF — połącz PDF z markdownu z obrazami lub innymi plikami.
- Kompresuj PDF — zmniejsz wynik, aby go udostępnić.