Markdown online bekijken zonder je bestanden te uploaden

Markdown is ontworpen om als platte tekst leesbaar te zijn, maar je wilt toch zien hoe het uiteindelijke document eruitziet: of de tabel klopt, de lijst goed genest is en het codeblok gemarkeerd wordt. Een live preview toont het weergegeven resultaat naast de bron en werkt het bij met elke toetsaanslag.

Deze handleiding vergelijkt de gangbare manieren om Markdown te bekijken, noemt de functies die in de praktijk echt verschil maken en laat een snelle werkwijze zien waarmee je lokale bestanden in de browser opent — zonder iets te installeren en zonder ze naar een server te sturen.

Drie manieren om Markdown te bekijken

1. Een preview in je code-editor

VS Code, JetBrains-IDE’s en veel andere editors hebben een ingebouwde Markdown-preview. Een goede optie als je die editor toch al de hele dag gebruikt. De nadelen: de editor moet geïnstalleerd zijn, voor formules en diagrammen zijn vaak extensies nodig, en je kunt hem niet even doorgeven aan een collega die alleen een README.md wil lezen.

2. Een online Markdown-viewer

Een website met links een editor en rechts een voorbeeld is de snelste optie: open een tabblad en begin met typen. Het addertje: online tools verschillen sterk. Sommige sturen je tekst naar een server om hem weer te geven, sommige slaan documenten zonder te vragen in je browser op, en veel ondersteunen alleen de basissyntaxis — geen tabellen, geen takenlijsten, geen formules.

3. Een zelf gehoste viewer

Een statische webapp die je zelf host, combineert het gemak van een website met volledige controle: hij staat op je eigen domein, ziet er voor je hele team hetzelfde uit en jij bepaalt wat hij wel en niet kan. Deze optie behandelen we uitgebreid in een Markdown-editor zelf hosten.

Waar let je op bij een Markdown-viewer?

Niet elke viewer werkt even prettig. Dit zijn de functies die ertoe doen zodra je er dagelijks een gebruikt:

• Directe weergave. Het voorbeeld moet bijwerken terwijl je typt, zonder knop “Weergeven” of merkbare vertraging.
• Gesynchroniseerd scrollen. In een lang document moet het voorbeeld de editor volgen, zodat de alinea die je bewerkt altijd rechts zichtbaar is.
• GitHub-Flavored Markdown. Tabellen, takenlijsten, doorhalen, voetnoten en meldingen moeten er net zo uitzien als op GitHub. Weet je niet precies wat dat zijn, kijk dan in de Markdown cheat sheet.
• Codemarkering voor de talen die je gebruikt.
• Formules en diagrammen als je technische documentatie schrijft: LaTeX-formules en Mermaid-diagrammen.
• Lokale bestanden openen. Slepen en neerzetten moet werken voor losse bestanden, meerdere bestanden en hele mappen — inclusief de afbeeldingen waarnaar een document verwijst.
• Export. Als het document klaar is, heb je het meestal nodig als HTML, pdf of een schoon .md-bestand.
• Lokale verwerking. Idealiter wordt de tekst in je browser weergegeven en verlaat hij je computer nooit. Dat is belangrijk voor interne documentatie, contracten, concepten en notities.

Een snelle werkwijze met Markdown Preview Editor

Markdown Preview Editor is een gratis, open-source editor die precies rond dit lijstje is gebouwd. Zo verloopt een typische sessie.

Stap 1: open de editor

Open de online versie of je eigen exemplaar. Je hoeft geen account aan te maken en niets te installeren. De interface is beschikbaar in 15 talen en volgt automatisch de taal van je browser.

Stap 2: open je bestanden

Sleep een .md-bestand naar de editor — of meerdere bestanden tegelijk, of een hele map. Elk document opent in een eigen tabblad met een eigen geschiedenis voor ongedaan maken. Afbeeldingen, audio en video die je samen met het document sleept, verschijnen in het voorbeeld, omdat de relatieve paden worden opgezocht in de map die je erin hebt gesleept.

Liever het toetsenbord? Druk op Ctrl+O (⌘O op een Mac) om bestanden te kiezen, of gebruik de knop Map om een map te openen.

Stap 3: schrijf met het voorbeeld ernaast

Typ links in de editor; het voorbeeld rechts wordt direct bijgewerkt en scrolt met je mee. De opmaakwerkbalk voegt koppen, lijsten, links, tabellen en codeblokken in. Minder vaak gebruikte tools — voetnoten, meldingen, formules, diagrammen — staan in de inklapbare rij Geavanceerde editor, zodat de werkbalk overzichtelijk blijft.

Wissel met één klik tussen drie weergaven: alleen de editor, gesplitst en alleen het voorbeeld. Op een telefoon past de indeling zich automatisch aan en blijft de werkbalk ingeklapt tot je hem nodig hebt.

Stap 4: opslaan of exporteren

Als je klaar bent, sla je het document op als .md, exporteer je het als zelfstandig HTML-bestand of druk je het af als pdf. Het artikel over Markdown omzetten naar HTML en pdf behandelt de opties uitgebreid.

Waar gaan je bestanden naartoe?

Bij veel webtools zie je niet zomaar of je tekst wordt geüpload. Een handige test: open de ontwikkelaarstools van de browser, ga naar het tabblad Network (Netwerk) en typ iets. Verschijnen er nieuwe verzoeken terwijl je typt, dan verlaat je tekst mogelijk de pagina.

Markdown Preview Editor geeft alles in de browser weer. Bestanden die je opent, worden lokaal gelezen, en documenten worden alleen in het geopende tabblad bewaard, tenzij je in de instellingen Documenten onthouden inschakelt. Externe afbeeldingen en links in een document worden pas geladen als je dat toestaat, dus alleen een bestand openen maakt ook geen contact met andere servers.

Tips voor een soepelere preview

• Houd afbeeldingen bij het document in een map images/ of assets/ en koppel ze met relatieve paden. Sleep daarna de hele map erin, en alles verschijnt.
• Gebruik één #-kop per bestand. Die wordt de titel van de geëxporteerde HTML en maakt lange documenten makkelijker te doorlopen.
• Zet regelnummers aan in de instellingen als je samen aan documentatie werkt — dan zijn reviewopmerkingen als “regel 42” makkelijk te volgen.
• Gebruik 's avonds de donkere modus. Het voorbeeld wisselt samen met de editor van thema.