Markdown naar PDF converteren

De Markdown-naar-PDF-converter van FileReshape maakt een .md-bestand in uw browser op met koppen, lijsten, tabellen, codeblokken en takenlijsten in GitHub-stijl, en u slaat het resultaat via het afdrukvenster van de browser op als PDF met selecteerbare tekst. Het bestand wordt niet geüpload. Afbeeldingen die alleen gelinkt zijn en niet ingesloten, verschijnen als hun beschrijving, en er is geen syntaxiskleuring of directe downloadknop.

Is een bestand niet goed omgezet? Mail naar [email protected], liefst met een klein voorbeeldbestand, dan wordt het opgelost.

In het kort

Waarom Markdown omzetten naar PDF

Markdown is hoe ontwikkelaars, schrijvers en notitie-apps zoals Obsidian, Joplin en Typora tekst bewaren: leesbaar als platte tekst, en opgemaakt zodra een app het toont. Buiten die apps is een .md-bestand gewoon een muur van hekjes en sterretjes, en dat wilt u niet naar een klant mailen, inleveren of afdrukken. Deze tool leest de Markdown in uw browser met marked, een opensource-parser die de regels van GitHub Flavored Markdown volgt, en zet hem op als een net document: koppen, vette en cursieve tekst, genummerde lijsten en opsommingen, takenlijsten met selectievakjes, tabellen met randen, citaten, en codeblokken in een lettertype met vaste breedte die doorlopen in plaats van buiten de pagina te vallen. De eigen afdrukengine van de browser schrijft daarna de PDF, zodat de tekst scherp en doorzoekbaar blijft. YAML-front-matter bovenaan het bestand, die blogs en statische sitegeneratoren gebruiken, wordt uit de PDF weggelaten.

Zo zet u Markdown om naar PDF

  1. Sleep uw .md-bestand in het vak, of klik om het te kiezen. Er verschijnt een voorbeeld van het opgemaakte document.
  2. Kies het paginaformaat, de marges en de tekstgrootte.
  3. Klik op “PDF maken”. Kies in het afdrukvenster van uw browser “Opslaan als PDF” als printer of bestemming en sla het bestand op.

Goed om te weten over Markdown en PDF

Afbeeldingen die alleen gelinkt zijn

Markdown verwijst meestal naar afbeeldingen via een adres, zoals ![Logo](images/logo.png) of een weblink. De tool heeft alleen het .md-bestand, niet de map eromheen, en haalt niets van het web op, dus zulke afbeeldingen verschijnen als een klein kader met hun beschrijving. Afbeeldingen die als data-URL in het bestand zijn ingesloten, worden wel afgedrukt. Wilt u de afbeeldingen toch in de PDF, open de Markdown dan in een editor die de afbeeldingen toont en druk vanuit die editor af.

HTML in de Markdown

Eenvoudige HTML zoals <br>, <sup>, <details> of een tabel in HTML blijft behouden. Scripts, frames, formulieren, stijlen en ingesloten video's worden verwijderd, omdat ze niet in een afgedrukt document thuishoren en onveilig kunnen zijn.

Geen syntaxiskleuring

Codeblokken worden afgedrukt in een lettertype met vaste breedte en een licht kader, maar zonder de kleuren die een editor gebruikt voor trefwoorden en strings. Lange coderegels lopen door, zodat er aan de rand van de pagina niets wordt afgekapt.

Markdown-varianten

Tabellen, takenlijsten, doorgehaalde tekst en automatische links volgen de regels van GitHub, die de meeste apps delen. Uitbreidingen die maar sommige apps hebben, zoals voetnoten, wiskundige formules, Mermaid-diagrammen, wikilinks tussen notities of callouts van Obsidian, worden als platte tekst getoond.

Over de bestandsformaten

Markdown

Markdown is een tekstformaat voor opgemaakte documenten, in 2004 bedacht door John Gruber. Hekjes maken koppen, sterretjes maken vette en cursieve tekst, en streepjes maken lijsten. GitHub, GitLab, Reddit, Obsidian, Notion-exports en veel documentatietools gebruiken het.

  • Een .md-bestand is platte tekst, dus het opent in elke teksteditor en werkt goed met versiebeheer zoals Git.
  • GitHub Flavored Markdown (GFM) voegt tabellen, takenlijsten, doorgehaalde tekst en automatische links toe aan de oorspronkelijke regels.
  • Afbeeldingen worden meestal via een adres gelinkt, dus ze staan in aparte bestanden naast het .md-bestand of op het web.

PDF

PDF (Portable Document Format) is in 1993 door Adobe ontwikkeld en is sinds 2008 een ISO-norm. Een pdf ziet er op elk apparaat hetzelfde uit en wordt daarom gebruikt voor contracten, facturen, formulieren, handleidingen en gescande documenten.

  • Een pagina kan tekst, vectorafbeeldingen en foto's bevatten, elk precies op zijn plaats.
  • Een gescand document bestaat meestal uit één afbeelding per pagina.
  • Een pdf kan worden beveiligd met een wachtwoord dat nodig is om hem te openen of te bewerken.

Veelgestelde vragen

Wordt mijn Markdown-bestand geüpload?

Nee. De Markdown wordt door uw browser op uw eigen apparaat gelezen en opgemaakt, en de PDF wordt geschreven door de afdrukfunctie van de browser. Er wordt niets naar een server gestuurd.

Hoe kom ik van de datum en het webadres op elke pagina af?

Zet “Kop- en voetteksten” uit in het afdrukvenster van de browser, meestal onder Meer instellingen. Daarmee verdwijnt ook de paginatitel bovenaan.

Waarom hebben mijn codeblokken geen grijze achtergrond in de PDF?

Browsers laten achtergrondkleuren weg bij het afdrukken, tenzij “Achtergrondafbeeldingen” is aangezet in het afdrukvenster. Het kader rond codeblokken wordt hoe dan ook afgedrukt.

Kan ik een README van GitHub omzetten?

Ja. Download het bestand README.md en sleep het hierheen. Badges en schermafbeeldingen die vanaf het web zijn gelinkt, verschijnen als hun beschrijving.