## Developer Workflow

GitHub README.md lokaal bekijken op Mac

Gepubliceerd maart 2026

Je hebt de README bewerkt. Nu wil je zien hoe het eruitziet voordat je pusht. Hier zijn drie manieren om dat te doen, van zwaargewicht tot instant.

## Waarom lokaal bekijken

Waarom lokaal bekijken?

Opmaak controleren voor het pushen. Kapotte tabellen, defecte links en verminkte codeblokken zijn genant in een publieke repo. Vang ze op voor git push.
Offline werken. Vliegtuigen, treinen, koffietentjes met slecht wifi. Je README zou geen internetverbinding nodig moeten hebben om te bekijken.
PR-documentatiewijzigingen beoordelen. Wanneer een pull request de README bijwerkt, wil je het gerenderde resultaat naast de code diff zien.
De commit-push-check-cyclus vermijden. Een commit pushen alleen om te zien hoe je README er op GitHub uitziet, vervuilt je git-geschiedenis en kost tijd.

## Methode 1

grip (CLI-tool)

pip install grip
grip README.md

grip rendert je Markdown via de GitHub API, zodat je pixelperfecte GitHub-rendering krijgt in je browser op localhost:6419.

Voordelen

Exacte GitHub-rendering (gebruikt hun API)

Nadelen

Vereist Python
Heeft een GitHub API-token nodig bij intensief gebruik (anders rate-limited)
Draait een lokale server die je moet starten en stoppen
Niet offline-vriendelijk (roept de GitHub API aan)

## Methode 2

VS Code ingebouwde preview

Open README.md in VS Code
Cmd + Shift + V → preview-paneel

VS Code heeft een ingebouwde Markdown-preview. Open het bestand, druk op de sneltoets en een zijpaneel toont de gerenderde uitvoer.

Voordelen

Al geinstalleerd voor de meeste ontwikkelaars
Werkt offline

Nadelen

Een volledige IDE opstarten om een README te bekijken is overdreven
Preview-rendering komt niet exact overeen met GitHub (geen callout-ondersteuning, andere tabelstijl)
Gebonden aan je editor — je kunt niet gewoon dubbelklikken op een bestand

## Methode 3 (Aanbevolen)

ShowMeMyMD — gewoon dubbelklikken

git clone <repo>
Dubbelklik op README.md
Klaar.

ShowMeMyMD is een native macOS Markdown-viewer. Stel het in als je standaard-app voor .md bestanden en elke README opent direct als gerenderde preview. Geen CLI. Geen server. Geen setup.

Volledige GitHub-Flavored Markdown-ondersteuning:

Tabellen met uitlijning
Takenlijsten met checkboxen
Fenced codeblokken met syntaxmarkering
GitHub-stijl callouts: NOTE, TIP, WARNING, IMPORTANT, CAUTION

Klonen, dubbelklik op README.md, klaar.

## Vergelijking

Vergelijking naast elkaar

Tool	Setup	GFM-nauwkeurigheid	Snelheid	Offline
grip	Python + pip install	Exact (GitHub API)	Traag (netwerk)	Nee
VS Code	Al geinstalleerd	Gedeeltelijk	Snel	Ja
ShowMeMyMD	Eenmalig installeren uit Mac App Store	Volledig GFM + callouts	Direct	Ja

## Verder lezen

Lees meer over ShowMeMyMD als Markdown-viewer voor Mac. Ontdek hoe het past in een developer workflow. Of lees onze gids over GitHub-stijl callouts.

Stop met pushen om je README te controleren

Dubbelklik op een willekeurig .md bestand en bekijk het direct gerenderd. GitHub-Flavored Markdown, syntaxmarkering, vier thema's. $2.99 in de Mac App Store.