Over Markdown omzetten naar een PDF
Markdown is de makkelijkste manier om een document te schrijven en de lastigste om er een te versturen.
U heeft de notities geschreven, de README, de specificatie, het rapport. In uw editor is het perfect. Dan vraagt iemand erom als PDF, en de mogelijkheden zijn: een toolchain installeren, alles in een tekstverwerker plakken en de opmaak met de hand repareren, of het naar een repository pushen en de pagina fotograferen.
Plak het in plaats daarvan hier. Het voorbeeld rechts is hoe de PDF eruit gaat zien, en de knop maakt er een van.
Wat de reis overleeft
Alles wat u van GitHub-Markdown verwacht:
- Koppen — alle niveaus, met de witruimte die een document hoort te hebben
- Lijsten — met opsommingstekens, genummerd en genest
- Tabellen — met randen en een gearceerde koprij
- Code — zo in de regel, en in blokken met hun inspringing intact
- Citaten, scheidingslijnen, vet, *cursief* en links
- Afbeeldingen, zolang het data-URI's of bereikbare URL's zijn
Het voorbeeld en de PDF worden uit dezelfde stylesheet getekend, dus wat u ziet is echt wat er wordt afgedrukt. Er is geen tweede opmaakstap die u nog kan verrassen.
Twee stijlen
- Rustig document — een schreeflettertype en ruime regelafstand. De juiste keuze voor een rapport, een voorstel, een lopend stuk tekst, alles wat iemand van begin tot eind leest.
- README-stijl — een schreefloos lettertype met onderstreepte koppen, dichter bij hoe een README op een codeplatform oogt. De juiste keuze voor documentatie en technische notities.
Pagina-instelling
A4 of Letter, staand of liggend, en een marge die u in millimeters opgeeft. Liggend is het onthouden waard voor alles met brede tabellen of lange coderegels — het is het verschil tussen een tabel die past en een tabel die afbreekt.
Paginanummers staan standaard aan en verschijnen gecentreerd onderaan elke pagina. Zet ze uit bij een document van één pagina, waar ze alleen ruis toevoegen.
Er verlaat niets uw apparaat
De Markdown wordt weergegeven en de PDF wordt geschreven in uw browser. Er wordt niets geüpload, dus:
- Niet-vrijgegeven specificaties, interne notities en klantwerk blijven waar ze zijn
- Er is geen bestandslimiet door een upload
- Het werkt offline zodra de pagina is geladen
- Uw tekst blijft tussen bezoeken in deze browser bewaard, zodat een gesloten tabblad uw werk niet kwijtraakt — en alleen in deze browser
Waarom de pagina's geschilderd worden en niet gezet
Elke pagina wordt als afbeelding getekend en in de PDF geplaatst, in plaats van als PDF-tekst geschreven. Dat is met opzet: de standaard PDF-lettertypen kunnen Hangul, Kana, Han of Cyrillisch helemaal niet coderen, en een Markdown-document kan in elke taal zijn.
Het tekenen gebruikt uw eigen systeemlettertypen, dus elk schrift wordt correct weergegeven. De prijs is dat de tekst in de uiteindelijke PDF niet selecteerbaar is — dezelfde afweging die Word naar PDF maakt, om dezelfde reden. Heeft u selecteerbare tekst nodig en is uw document puur Latijns schrift, dan laat CV-bouwer zien hoe de andere aanpak eruitziet.
Wat mensen omzetten
- Een README of documentatiepagina, voor iemand die geen codeplatform gebruikt
- Vergadernotities in Markdown, die als document verder gaan
- Een specificatie of voorstel opgesteld in een teksteditor
- Studieaantekeningen om af te drukken of op een tablet te lezen
- Een changelog of release-notitie om bij een e-mail te voegen
- Lesmateriaal in Markdown geschreven en als PDF uitgedeeld
Goed om te weten
- Ruwe HTML in uw Markdown wordt vóór het weergeven opgeschoond, dus een geplakt document kan niets uitvoeren
- Een heel lang document kost enkele seconden per pagina — al het werk gebeurt lokaal
- Afbeeldingen van internet verschijnen alleen als de site toestaat dat een andere pagina ze leest; als data-URI geplakte afbeeldingen werken altijd
- Voor de andere richting, of om gewoon Markdown te schrijven, gebruikt u de Markdown-editor
- Om het resultaat met een andere PDF samen te voegen, gebruikt u PDF samenvoegen
Zo gebruikt u het
- Plak uw Markdown links, of druk op .md openen om een bestand te laden
- Controleer het voorbeeld rechts — zo gaat de PDF eruitzien
- Kies het paginaformaat, de richting, de marge en de stijl
- Vink Paginanummers toevoegen aan als u ze wilt
- Druk op PDF maken en daarna op PDF downloaden
Verwante tools
- Markdown-editor — Markdown schrijven met werkbalk en live voorbeeld
- Word naar PDF — dezelfde PDF-engine, beginnend bij een .docx
- PDF naar tekst — platte tekst weer uit een PDF halen
- PDF samenvoegen — deze PDF aan andere koppelen
- Paginanummers toevoegen aan PDF — een bestaande PDF nummeren
- PDF comprimeren — het bestand verkleinen voor het versturen
