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.