## Entwickler-Workflow

GitHub README.md lokal auf dem Mac anzeigen

Veroeffentlicht Maerz 2026

Du hast die README bearbeitet. Jetzt willst du sehen, wie sie aussieht, bevor du pushst. Hier sind drei Wege, das zu tun — von schwergewichtig bis sofort.

## Warum lokal anzeigen

Warum lokal in der Vorschau anzeigen?

Formatierung vor dem Pushen pruefen. Kaputte Tabellen, defekte Links und verstuemmelte Code-Bloecke sind peinlich in einem oeffentlichen Repository. Fange sie vor git push ab.
Offline arbeiten. Flugzeuge, Zuege, Cafes mit schlechtem WLAN. Deine README sollte keine Internetverbindung zum Ueberpruefen brauchen.
PR-Dokumentationsaenderungen pruefen. Wenn ein Pull Request die README aktualisiert, willst du das gerenderte Ergebnis neben dem Code-Diff sehen.
Den Commit-Push-Pruef-Zyklus vermeiden. Einen Commit nur zu pushen, um zu sehen, wie deine README auf GitHub gerendert wird, verschmutzt deine Git-History und verschwendet Zeit.

## Methode 1

grip (CLI-Tool)

pip install grip
grip README.md

grip rendert dein Markdown ueber die GitHub API, sodass du pixelgenaues GitHub-Rendering in deinem Browser unter localhost:6419 bekommst.

Vorteile

Exaktes GitHub-Rendering (nutzt deren API)

Nachteile

Erfordert installiertes Python
Braucht einen GitHub API Token bei haeufiger Nutzung (sonst Rate-limitiert)
Startet einen lokalen Server, den du starten und stoppen musst
Nicht offline-freundlich (ruft die GitHub API auf)

## Methode 2

VS Code eingebaute Vorschau

README.md in VS Code oeffnen
Cmd + Shift + V → Vorschau-Bereich

VS Code hat eine eingebaute Markdown-Vorschau. Oeffne die Datei, druecke den Tastaturkuerzel und ein Seitenpanel zeigt die gerenderte Ausgabe.

Vorteile

Bei den meisten Entwicklern bereits installiert
Funktioniert offline

Nachteile

Eine komplette IDE zu starten, um eine README anzuzeigen, ist uebertrieben
Vorschau-Rendering stimmt nicht genau mit GitHub ueberein (keine Callout-Unterstuetzung, anderes Tabellen-Styling)
An deinen Editor gebunden — man kann nicht einfach eine Datei doppelklicken

## Methode 3 (Empfohlen)

ShowMeMyMD — einfach doppelklicken

git clone <repo>
Doppelklick README.md
Fertig.

ShowMeMyMD ist ein nativer macOS Markdown-Viewer. Setze ihn als Standard-App fuer .md Dateien und jede README oeffnet sich sofort als gerenderte Vorschau. Kein CLI. Kein Server. Keine Einrichtung.

Volle GitHub-Flavored Markdown Unterstuetzung:

Tabellen mit Ausrichtung
Aufgabenlisten mit Checkboxen
Fenced Code Blocks mit Syntaxhervorhebung
GitHub-Style Callouts: NOTE, TIP, WARNING, IMPORTANT, CAUTION

Klonen, README.md doppelklicken, fertig.

## Vergleich

Vergleich Seite an Seite

Tool	Einrichtung	GFM-Genauigkeit	Geschwindigkeit	Offline
grip	Python + pip install	Exakt (GitHub API)	Langsam (Netzwerk)	Nein
VS Code	Bereits installiert	Teilweise	Schnell	Ja
ShowMeMyMD	Einmal aus Mac App Store installieren	Volles GFM + Callouts	Sofort	Ja

## Weiterlesen

Erfahre mehr ueber ShowMeMyMD als Markdown-Viewer fuer Mac. Sieh wie es in einen Entwickler-Workflow passt. Oder lies unseren Ratgeber zu GitHub-Style Callouts.

Hoer auf zu pushen, um deine README zu pruefen

Doppelklicke eine beliebige .md Datei und sieh sie sofort gerendert. GitHub-Flavored Markdown, Syntaxhervorhebung, vier Themes. $2.99 im Mac App Store.