Konwertuj Markdown na PDF

Konwerter Markdown na PDF od FileReshape formatuje plik .md w Twojej przeglądarce, z nagłówkami, listami, tabelami, blokami kodu i listami zadań w stylu GitHuba, a Ty zapisujesz wynik jako PDF z zaznaczalnym tekstem przez okno drukowania przeglądarki. Plik nie jest wysyłany na serwer. Obrazy, które są tylko podlinkowane, a nie osadzone, pokazują się jako ich opis, a kolorowania składni i przycisku bezpośredniego pobierania nie ma.

Plik nie przekonwertował się poprawnie? Napisz na [email protected], najlepiej z małym przykładowym plikiem, a błąd zostanie naprawiony.

Najważniejsze informacje

Po co zamieniać Markdown w PDF

Markdown to sposób, w jaki programiści, autorzy i aplikacje do notatek, takie jak Obsidian, Joplin i Typora, przechowują tekst: czytelny jako zwykły tekst i sformatowany, gdy wyświetla go aplikacja. Poza tymi aplikacjami plik .md to tylko ściana krzyżyków i gwiazdek, a nie coś, co chcesz wysłać klientowi e-mailem, oddać czy wydrukować. To narzędzie odczytuje Markdown w Twojej przeglądarce za pomocą marked, parsera open source zgodnego z regułami GitHub Flavored Markdown, i składa go w czytelny dokument: nagłówki, pogrubiony tekst i kursywa, listy numerowane i punktowane, listy zadań z polami wyboru, tabele z obramowaniem, cytaty oraz bloki kodu czcionką o stałej szerokości, które zawijają się zamiast wychodzić poza stronę. Następnie PDF zapisuje mechanizm drukowania samej przeglądarki, więc tekst pozostaje ostry i przeszukiwalny. Nagłówek YAML (front matter) na początku pliku, używany przez blogi i generatory stron statycznych, jest pomijany w PDF-ie.

Jak przekonwertować Markdown na PDF

  1. Upuść plik .md w polu albo kliknij, aby go wybrać. Pojawi się podgląd sformatowanego dokumentu.
  2. Wybierz rozmiar strony, marginesy i rozmiar tekstu.
  3. Kliknij „Utwórz PDF”. W oknie drukowania przeglądarki wybierz „Zapisz jako PDF” jako drukarkę lub miejsce docelowe i zapisz plik.

Co warto wiedzieć o Markdown i PDF

Obrazy, które są tylko podlinkowane

Markdown zwykle wskazuje obrazy adresem, na przykład ![Logo](images/logo.png) albo linkiem do internetu. Narzędzie ma tylko plik .md, a nie folder wokół niego, i niczego nie pobiera z sieci, więc takie obrazy pojawiają się jako małe pole z opisem. Obrazy osadzone w pliku jako data URL są drukowane. Aby w inny sposób umieścić obrazy w PDF-ie, otwórz Markdown w edytorze, który pokazuje obrazy, i drukuj stamtąd.

HTML w Markdownie

Prosty HTML, taki jak <br>, <sup>, <details> czy tabela zapisana w HTML, zostaje zachowany. Skrypty, ramki, formularze, style i osadzone filmy są usuwane, bo nie pasują do drukowanego dokumentu i mogą być niebezpieczne.

Bez kolorowania składni

Bloki kodu są drukowane czcionką o stałej szerokości w jasnej ramce, ale bez kolorów, których edytor używa dla słów kluczowych i ciągów znaków. Długie wiersze kodu są zawijane, więc nic nie zostaje obcięte przy krawędzi strony.

Odmiany Markdowna

Tabele, listy zadań, przekreślenia i automatyczne linki działają według reguł GitHuba, które stosuje większość aplikacji. Rozszerzenia dostępne tylko w niektórych aplikacjach, takie jak przypisy, wzory matematyczne, diagramy Mermaid, linki wiki między notatkami czy bloki callout z Obsidiana, są pokazywane jako zwykły tekst.

O formatach plików

Markdown

Markdown to tekstowy format do pisania sformatowanych dokumentów, stworzony przez Johna Grubera w 2004 roku. Krzyżyki tworzą nagłówki, gwiazdki pogrubienie i kursywę, a myślniki listy. Używają go GitHub, GitLab, Reddit, Obsidian, eksporty z Notion i wiele narzędzi do dokumentacji.

  • Plik .md to zwykły tekst, więc otwiera się w każdym edytorze tekstu i dobrze współpracuje z systemami kontroli wersji, takimi jak Git.
  • GitHub Flavored Markdown (GFM) dodaje do pierwotnych reguł tabele, listy zadań, przekreślenie i automatyczne linki.
  • Obrazy są zwykle linkowane przez adres, więc znajdują się w osobnych plikach obok pliku .md lub w internecie.

PDF

PDF (Portable Document Format) został opracowany przez Adobe w 1993 roku, a od 2008 roku jest normą ISO. Plik PDF wygląda tak samo na każdym urządzeniu, dlatego używa się go do umów, faktur, formularzy, instrukcji i zeskanowanych dokumentów.

  • Strona może zawierać tekst, grafikę wektorową i obrazy, każdy element umieszczony dokładnie na swoim miejscu.
  • Zeskanowany dokument to zwykle jeden obraz na stronę.
  • PDF można zabezpieczyć hasłem, które jest potrzebne do jego otwarcia lub edycji.

Najczęściej zadawane pytania

Czy mój plik Markdown jest wysyłany na serwer?

Nie. Markdown jest odczytywany i formatowany przez Twoją przeglądarkę na Twoim własnym urządzeniu, a PDF zapisuje funkcja drukowania przeglądarki. Nic nie trafia na serwer.

Jak pozbyć się daty i adresu strony na każdej stronie?

Wyłącz „Nagłówki i stopki” w oknie drukowania przeglądarki, zwykle w sekcji „Więcej ustawień”. To usuwa też tytuł strony u góry.

Dlaczego bloki kodu nie mają w PDF-ie szarego tła?

Przeglądarki pomijają kolory tła przy drukowaniu, chyba że w oknie drukowania włączona jest „Grafika tła”. Ramka wokół bloków kodu drukuje się w każdym przypadku.

Czy mogę przekonwertować README z GitHuba?

Tak. Pobierz plik README.md i upuść go tutaj. Plakietki (badges) i zrzuty ekranu podlinkowane z internetu pokazują się jako ich opisy.