Pytania i odpowiedzi

Odpowiedzi na najczęstsze pytania o MarkPDF

Jaka składnia Markdown jest obsługiwana?

MarkPDF obsługuje składnię CommonMark: nagłówki, akapity, wyróżnienia, listy, linki, obrazy, bloki kodu, cytaty i linie poziome, a także tabele w stylu GitHub, przekreślenia i automatyczne linki. Wzory zapisuje się między $ … $ i $$ … $$.

PDF tekstowy czy graficzny: czym się różnią?

Są dwa sposoby eksportu. „Pobierz PDF (tekst)” korzysta z mechanizmu drukowania przeglądarki: tekst można zaznaczać i przeszukiwać, linki działają, a plik jest mały; w oknie drukowania wybierz „Zapisz jako PDF”. „Szybkie pobieranie (obraz)” zapisuje strony jako obrazy jednym kliknięciem (ok. 180 DPI na A4): wygląda dokładnie jak podgląd, ale tekstu nie da się zaznaczyć, a wyszukiwarki i systemy do selekcji CV (ATS) go nie odczytają. W przeglądarkach wbudowanych w aplikacje (Messenger, Facebook, Instagram…) drukowanie często nie działa, dlatego tam najpierw proponujemy wersję graficzną.

Czy obsługiwane są wzory matematyczne i podświetlanie kodu?

Tak. Bloki kodu są podświetlane przez highlight.js (ponad 190 języków), a wzory w $ … $, $$ … $$, \( … \) lub \[ … \] są renderowane przez KaTeX.

Czy jest limit rozmiaru pliku?

Wszystko jest przetwarzane w przeglądarce, więc faktyczny limit zależy od Twojego urządzenia. Zwykle pliki Markdown o rozmiarze kilkudziesięciu KB (dziesiątki tysięcy słów) działają bez problemu. Bardzo duże dokumenty mogą wyświetlać się nieco dłużej.

Jak wybrać właściwą czcionkę?

Dla polskiego wystarczy czcionka domyślna; czcionki dla arabskiego, hindi i innych pism wczytują się same. Dla chińskiego uproszczonego wybierz Noto Sans SC lub Source Han Sans, dla tradycyjnego Noto Sans TC, dla japońskiego Noto Sans JP, a dla koreańskiego Noto Sans KR. Do dokumentów wielojęzycznych polecamy Source Han Sans.

Jak szybka jest konwersja?

To zależy od długości i złożoności dokumentu. Zwykły artykuł na 2000 słów zajmuje zwykle 2–3 sekundy. Długie dokumenty z wieloma tabelami lub blokami kodu mogą potrzebować 5–10 sekund. Wszystko dzieje się w przeglądarce, bez przesyłania danych.

Czy przechowujecie treść moich dokumentów?

Nie. Całe przetwarzanie w MarkPDF odbywa się w Twojej przeglądarce, a treść nigdy nie trafia na nasze serwery. Właśnie ze względu na prywatność wybraliśmy renderowanie w przeglądarce.

Czy można konwertować wiele plików naraz?

Obecna wersja konwertuje jeden dokument naraz. Konwersja wsadowa nie jest jeszcze dostępna.

Czy mogę zmienić wygląd PDF?

W panelu ustawień wybierzesz czcionkę, jej rozmiar, format papieru (A4, Letter, A5) i marginesy; wybór zostaje zapamiętany na tym urządzeniu. Własny CSS oraz nagłówki i stopki nie są jeszcze dostępne.

Czy jest API?

Na razie nie. MarkPDF działa w całości w przeglądarce. Jeśli chcesz generować PDF we własnej aplikacji, zajrzyj do bibliotek open source, których używamy (markdown-it + html2pdf.js).

Jakie przeglądarki są obsługiwane?

MarkPDF działa we wszystkich nowoczesnych przeglądarkach: Chrome 80+, Firefox 75+, Safari 14+ i Edge 80+. Najlepiej działa z aktualnym Chrome lub Edge. Internet Explorer nie jest obsługiwany.

Czy działa na telefonie?

Tak. Interfejs dopasowuje się do telefonów i tabletów. Na małym ekranie edytor i podgląd są jeden pod drugim; przełączasz je przyciskiem „Podgląd”.

Czy można wstawiać obrazy?

Tak. Użyj składni obrazów Markdown, aby wstawić obrazy z internetu. Obecna wersja nie pozwala wysyłać obrazów z urządzenia: najpierw umieść obraz w serwisie do hostingu zdjęć, a potem użyj jego linku.

Czy mogę eksportować do innych formatów?

Na razie głównym formatem jest PDF. Eksport do HTML jest w przygotowaniu, a inne formaty, np. Word (.docx), mogą pojawić się w przyszłości.

Gdzie znajdę pomoc?

MarkPDF nie oferuje indywidualnego wsparcia. Odpowiedzi na większość pytań znajdziesz na tej stronie, w poradniku i w przewodnikach po rozwiązywaniu problemów, które szczegółowo omawiają kłopoty z czcionkami, kodowaniem i układem.