Print Markdown mooi af

De snelste manier om mdprint te proberen is gewoon beginnen met typen in de editor op de homepage. Die opent met een voorbeelddocument dat elke functie demonstreert - tabellen, code, wiskunde, diagrammen - zodat je meteen ziet hoe een afgewerkte pagina eruitziet. Verwijder het voorbeeld en typ je eigen inhoud, of plak het vanuit waar je het ook hebt geschreven.

Als je al een Markdown-bestand op je computer hebt, heb je twee manieren om het te laden. De eerste is door het uit je bestandsbeheer te slepen en op het editorpaneel los te laten. Tijdens het slepen verschijnt er een hooglicht rond de drop zone. Laat het bestand los en de editor vult zich met de inhoud. De tweede is op de Importeer-knop in de werkbalk klikken en het bestand selecteren in de bestandskiezer. Beide methoden lezen het bestand lokaal - er wordt niets geüpload.

mdprint accepteert .md-, .markdown- en .txt-bestanden. De .txt-extensie is handig voor documenten die als Markdown geschreven zijn maar met een algemene extensie opgeslagen door een andere tool. Als je een bestand met een andere extensie probeert te importeren, toont mdprint een foutmelding en blijft je huidige inhoud ongemoeid.

Als je nog nooit Markdown hebt geschreven, zijn de regels in vijf minuten te leren. Je schrijft platte tekst en vier tekens doen het meeste werk. Het #-symbool aan het begin van een regel maakt een kop - één # voor de grootste, zes ###### voor de kleinste. De symbolen * en _ rond een woord maken het cursief met één aan elke kant en vet met twee. Het symbool - of * aan het begin van een regel maakt een bullet. Spring twee spaties in om een bullet onder een andere te nesten.

Code wordt verwerkt met backticks. Eén backtick aan elke kant van een uitdrukking maakt er `inline code` van. Drie backticks op een eigen regel beginnen een codeblok en drie meer beëindigen het. Als je een taalnaam direct achter de openende drie backticks zet (```python, ```typescript, ```sql), krijgt het codeblok syntax-highlighting in die taal. Zonder taalhint probeert de highlighter te raden op basis van de inhoud, wat meestal werkt voor populaire talen.

Links en afbeeldingen gebruiken beide vierkante haken en haakjes. Een link is [de tekst die je ziet](de URL). Een afbeelding is hetzelfde met een voorafgaand uitroepteken: . Wanneer je naar PDF print, worden afbeelding-URL's die naar publiek toegankelijke servers wijzen opgehaald en ingesloten. Afbeeldingen op je lokale machine of achter authenticatie worden niet weergegeven - drop ze rechtstreeks in de editor als base64 data-URL's als je ze inline nodig hebt.

Tabellen zijn het ene stuk Markdown dat er in de bron lastig uitziet maar netjes rendert. Een kopregel, een scheidingsregel van streepjes en een of meer datarijen, allemaal gescheiden door pipes. De kolommen hoeven niet uitgelijnd te zijn in de bron - de renderer regelt de spatiëring. Voeg een dubbele punt toe aan één of beide uiteinden van de streepjes in de scheidingsregel om de uitlijning te bepalen: :--- voor links, ---: voor rechts, :---: voor gecentreerd.

Wiskundevergelijkingen gebruiken TeX-syntax tussen dollartekens. Eén dollarteken aan elke kant geeft je inline wiskunde: $a^2 + b^2 = c^2$. Twee dollartekens op eigen regels geven een display-vergelijking, gecentreerd op een eigen regel en groter. Alle LaTeX-wiskundecommando's die je zou verwachten - \frac, \int, \sum, \sqrt, Griekse letters, matrices, de AMS-symbolenset - werken omdat mdprint KaTeX gebruikt, dat dezelfde syntax implementeert.

Diagrammen gebruiken Mermaid-syntax in een fenced codeblok met de mermaid-taaltag. Het eenvoudigste diagram is een stroomdiagram: open met graph LR (links-naar-rechts) of graph TD (boven-naar-onder), en schrijf vervolgens nodes verbonden door pijlen. Mermaid ondersteunt ook sequentiediagrammen (berichtflow tussen actoren over tijd), gantt-grafieken (projectplanning met afhankelijkheden), klassediagrammen (objectrelaties) en toestandsdiagrammen (toestandsmachines). De Mermaid-documentatie heeft voorbeelden voor elk type.

Voetnoten laten je je proza leesbaar houden terwijl je gedetailleerde citaten of opmerkingen toevoegt. Markeer een voetnoot in je tekst met [^1] (het nummer mag van alles zijn - ze worden in de output hernummerd). Definieer ergens anders in het document de voetnoot met [^1]: de voetnootinhoud. mdprint verzamelt alle voetnoten aan het einde van het geprinte document en voegt terugverwijzingen toe die elke voetnoot koppelen aan de plek waar deze in de tekst voorkomt.

Als je document lang is, laat de letterlijke tekst [[toc]] in de bron vallen waar je wilt dat een inhoudsopgave verschijnt. mdprint vervangt het door een geneste lijst met links naar elke H2 en H3 in het document. In de geprinte PDF wordt diezelfde inhoudsopgave een navigatie-outline die PDF-lezers kunnen gebruiken.

Open het instellingenpaneel vanaf de werkbalk om te bepalen hoe je PDF wordt gegenereerd. Paginaformaat heeft twee opties: A4 (de standaard buiten Noord-Amerika) of Letter (de standaard binnen Noord-Amerika). Oriëntatie wisselt tussen staand en liggend - liggend is handig voor documenten met brede tabellen of diagrammen. Marges biedt drie presets: smal geeft meer bruikbare ruimte voor dichte inhoud, normaal is de conventionele middenweg, en breed laat ruimte voor handgeschreven aantekeningen op een geprinte kopie.

De editor heeft eigen lichte en donkere thema's, onafhankelijk van de rest van de pagina. De toggle in de werkbalk schakelt ertussen. Het voorbeeld en de afdruk blijven hoe dan ook in lichte modus, omdat lichte achtergronden goed printen op papier.

Als je regelmatig dezelfde set opties gebruikt, wordt je laatste selectie lokaal onthouden en automatisch toegepast de volgende keer dat je mdprint opent op dezelfde browser.

De Print-knop opent de native printdialoog van je browser. Daar biedt elk modern besturingssysteem Opslaan als PDF aan als bestemming - Chrome, Firefox, Safari en Edge ondersteunen het allemaal op macOS, Windows en Linux. Via de printdialoog heb je de meeste controle: je kunt elke printer kiezen, elke pagina vooraf bekijken, oriëntatie per pagina wijzigen als je driver dat ondersteunt, en op sommige printers kun je papierladen of nietjes wijzigen.

De PDF downloaden-knop slaat de printdialoog over en genereert een PDF-bestand rechtstreeks in de browser, en start dan een download. Het gebruikt je huidige instellingen (paginaformaat, oriëntatie, marges) om de output op te maken. Deze route is sneller als je precies weet wat je wilt en de flexibiliteit van de printdialoog niet nodig hebt. Het werkt door de pagina als afbeelding met hoge resolutie te renderen en die afbeelding in de PDF te plaatsen, dus het resultaat komt altijd overeen met wat je op het scherm ziet. De keerzijde: omdat de pagina een afbeelding wordt, is de tekst in deze PDF niet selecteerbaar of doorzoekbaar.

De twee routes verschillen in wat er uiteindelijk in het bestand terechtkomt. Opslaan als PDF, via de Print-knop, houdt tekst als tekst: die blijft selecteerbaar en doorzoekbaar, blijft scherp bij elke zoom, en diagrammen blijven vectoren. PDF downloaden is daarentegen een beeldmomentopname met één klik, dus snel en pixelnauwkeurig, maar de tekst is niet selecteerbaar. Gebruik Opslaan als PDF wanneer je selecteerbare tekst of het scherpste resultaat bij elke zoom wilt; gebruik PDF downloaden wanneer je gewoon een snelle, exacte kopie wilt van wat op het scherm staat zonder de printdialoog te openen.

Pagina-einden op vreemde plekken. mdprint vermijdt breken binnen codeblokken, tabellen en diagrammen, maar gokt niet voor proza. Als een kop onderaan een pagina belandt met de sectie-inhoud op de volgende pagina, is de makkelijkste oplossing een paar zinnen ervoor of erna toe te voegen om de kop te verschuiven. Er is geen handmatige pagina-einde-syntax in V1 - die toevoegen staat op de V2-lijst.

Afbeeldingen verschijnen niet in de PDF. De meest voorkomende oorzaak is een afbeelding-URL die wijst naar je lokale bestandssysteem (file://) of naar een server die geen cross-origin toegang toestaat. Sluit de afbeelding ofwel in als data-URL rechtstreeks in de Markdown-bron, of upload deze naar een afbeeldinghost die publieke leestoegang toestaat. Imgur, GitHub's user-content servers en de meeste CDN's werken.

Wiskunde rendert niet. Controleer de bron op niet-ge-escapete dollartekens in gewone tekst - een verdwaalde $ kan een wiskundespan starten die de rest van de paragraaf opslokt. Als je een letterlijk dollarteken in proza nodig hebt, escape het: \$. Als de wiskundesyntax correct is maar de vergelijking nog steeds niet rendert, staat het LaTeX-commando misschien niet op KaTeX's ondersteunde lijst - de KaTeX-documentatie heeft een volledige referentie.

Het diagram is leeg. Mermaid is streng met syntax. De meest voorkomende fouten zijn een ontbrekende spatie na graph LR, een node-ID met een spatie erin (gebruik camelCase of underscores), of een pijl die naar een ongedefinieerde node wijst. Open de developer console van je browser - Mermaid logt een specifiek foutbericht wanneer parsen mislukt.

Tabellen lopen vreemd over. Als een tabel breder is dan de pagina, schaalt mdprint deze terug om te passen. Schakel voor heel brede tabellen over naar liggende oriëntatie in Instellingen, of herstructureer de tabel naar een lijst. PDF handelt horizontaal scrollen niet af zoals het web.

Gebruik de toetscombinaties. Cmd+P (of Ctrl+P op Windows en Linux) opent de printdialoog. Cmd+S (Ctrl+S) start PDF downloaden. De eigen toetscombinaties van de browser voor zoeken (Cmd+F), opnieuw laden (Cmd+R) en zoomen (Cmd+plus/min) werken allemaal normaal - ze conflicteren niet met mdprint.

Begin elk document met een H1. De eerste H1 wordt de voorgestelde PDF-bestandsnaam, de documenttitel voor toegankelijkheid en de prominente kop bovenaan de geprinte pagina. Als je begint met H2 of lager, valt de bestandsnaam terug op 'document.pdf' en moet je hem na download handmatig hernoemen.

Sluit afbeeldingen in als data-URL's wanneer privacy belangrijk is. Als je niet wilt dat een PDF-lezer afbeeldingen ophaalt van een externe server wanneer hij je bestand opent, converteer de afbeelding dan naar een base64 data-URL en sluit deze rechtstreeks in. De meeste besturingssystemen hebben een ingebouwde of specifieke tool voor deze conversie. Het resulterende bestand is groter, maar volledig zelfstandig.

Gebruik takenlijsten voor afgedrukte checklists. Als je een papieren checklist maakt - een paklijst, een verzendchecklist, een stap-voor-stap procedure - gebruik dan Markdown-takenlijstsyntax met - [ ]. De vakjes printen als vierkantjes die je met een pen kunt aanvinken.

Combineer mermaid en code in technische documentatie. Een veelvoorkomend patroon is een stroomdiagram van een proces tonen, gevolgd door de eigenlijke code die het implementeert. Markdown laat je beide in hetzelfde bestand doen, en mdprint rendert ze op een manier die netjes naast elkaar print.

Cmd+P of Ctrl+P - printdialoog openen.

Cmd+S of Ctrl+S - downloaden als PDF.

Cmd+B of Ctrl+B in de editor - geselecteerde tekst vet maken.

Cmd+I of Ctrl+I in de editor - geselecteerde tekst cursief maken.

Cmd+/ of Ctrl+/ in de editor - commentaar voor de huidige regel wisselen (HTML-commentaar in Markdown-context).

Esc in de editor bij volledig scherm - volledig scherm verlaten.