showmd

Was ist showmd?

showmd ist eine kostenlose Quick-Look-Erweiterung für macOS, die Markdown-Dateien (.md und verwandte Erweiterungen) lesbarer als das Standardverhalten des Finders vorschaut. Ihr Kernzweck ist das Rendern von Markdown mit Formatierung bei gleichzeitigem Zugriff auf den Quelltext.

Statt rohen Texts beim Drücken der Leertaste auf eine .md-Datei im Finder zeigt showmd Markdown gerendert an und bietet einen Render-/Quell-Umschalter. Zusätzlich parst sie YAML-Frontmatter zu einer einklappbaren Metadatentabelle, die gängige Dokumentations- und AI-Prompt-Workflows unterstützt, die auf Markdown-Struktur angewiesen sind.

Hauptfunktionen

• Quick-Look-Vorschau für Markdown im Finder: Leertaste auf Markdown-Datei drücken, um formatierten Output ohne Browser oder Editor zu sehen.
• Render ↔ Quell-Umschalter: Mit einem Klick zwischen gerendertem Markdown und rohem Quelltext wechseln.
• YAML-Frontmatter als einklappbare Metadatentabelle: Erkennt „gefundene Schlüssel“ im Frontmatter und zeigt sie standardmäßig einklappbar in einer Tabelle an.
• Markdown-Features über Markdown-Parser: Unterstützt GitHub Flavored Markdown-Elemente wie Tabellen, Aufgabenlisten, Durchstreichungen, Autolinks, Fußnoten u. v. m.
• Syntaxbewusste Darstellung für Code und Sonderinhalte: Code-Blöcke mit sprachspezifischer Hervorhebung (190+ Sprachen), Inline- und Block-LaTeX-Mathematik via KaTeX, Mermaid-Diagramme aus Code-Blöcken.
• AI-orientierte Tag-Darstellung: Benutzerdefinierte XML-ähnliche Tags aus AI-Prompts (z. B. , , ) werden als beschriftete, umrandete Blöcke statt roher Winkelklammern gerendert.
• Keine Cloud- oder Hintergrund-Uploads: Die Seite betont „No cloud. No uploads. No telemetry“, d. h. Dateien werden standardmäßig lokal vorgeschaut.
• Inline-Bildbehandlung in Quick Look: Relative Bildpfade werden korrekt aufgelöst, sodass lokale Screenshots/Diagramme in der Vorschau erscheinen.

So verwenden Sie showmd

1. showmd für macOS herunterladen und einmal öffnen.
2. Unter Systemeinstellungen → Datenschutz & Sicherheit → Erweiterungen → Quick Look showmd aktivieren (die Seite beschreibt dies als einzelnen Schalter).
3. Im Finder Markdown-Datei auswählen und Leertaste drücken, um mit showmd vorzuschauen.
4. Den Render-/Quell-Umschalter nutzen, um zwischen formatiertem Output und zugrunde liegendem Markdown zu wechseln. Die Seite erwähnt zudem eine Option zum Kopieren als HTML.

Anwendungsfälle

• Lesen von als Markdown gespeicherter Dokumentation: README-Dateien mit formatierten Überschriften, Listen, Links und Tabellen im Finder vorschauen, ohne ihn zu verlassen.
• Überprüfen von AI-Prompt-/Konfigurationsdateien in Markdown: AI-Agenten-Anweisungsdateien mit XML-ähnlichen Tags ansehen, Tags als beschriftete Blöcke für schnelles Scannen gerendert.
• YAML-Frontmatter in statischen Site-Inhalten prüfen: Frontmatter-Tabelle bei Bedarf ausklappen, um Titel oder Konfigurationsschlüssel zu checken, sonst einklappbar beim lockeren Lesen.
• Technische Inhalte mit Code, Mathe oder Diagrammen kontrollieren: Syntaxhervorhebung für Code-Blöcke, LaTeX-Ausdrücke und Mermaid-Flussdiagramme inline gerendert statt als Rohtext.
• Relative Bilder in lokalen Notizen/Repo-Docs verifizieren: Sicherstellen, dass per relativen Pfaden referenzierte Bilder korrekt in der Quick-Look-Vorschau erscheinen.

FAQ

Wie aktiviere ich showmd im Finder?
showmd herunterladen, einmal öffnen, dann zu Systemeinstellungen → Datenschutz & Sicherheit → Erweiterungen → Quick Look gehen und die Erweiterung aktivieren. Beim ersten Start fragt macOS ggf. nach Zugriffsrechten auf Daten anderer Apps; Zulassen klicken.

Ersetzt showmd das Öffnen eines Browsers?
Die Seite stellt showmd als Möglichkeit dar, Markdown direkt in macOS Quick Look vorzuschauen, statt einen Browser für gerenderten Output zu öffnen.

Kann ich zwischen gerendertem Output und originalem Markdown wechseln?
Ja. showmd bietet einen Render- & Quell-Umschalter, der mit einem Klick funktioniert.

Wie handhabt showmd YAML-Frontmatter?
Es parst YAML-Frontmatter zu einer einklappbaren Tabelle, standardmäßig einklappbar, die Sie ausklappen können, um Metadaten zu sehen.

Gibt es eine Cloud-Komponente?
Die Seite betont „No cloud. No uploads. No telemetry“, d. h. Vorschauen werden standardmäßig lokal gehandhabt.

Alternativen

• Markdown-Dateien in einem dedizierten Markdown-Viewer/Editor öffnen: Verwenden Sie eine App, die für Markdown-Rendering und Export entwickelt wurde. Diese Optionen enthalten oft mehr Bearbeitungstools, während showmd speziell als Quick-Look-Vorschau positioniert ist.
• Browserbasierten Markdown-Renderer nutzen: Laden Sie Inhalte hoch oder fügen Sie sie in einen Online-Viewer ein, um gerendertes Output zu erhalten. Im Vergleich zu showmd fügt dies einen Browser-Schritt hinzu und hält Dateien möglicherweise nicht strikt lokal.
• Auf die macOS-Quick-Look-Standardvorschau setzen: Die Leertasten-Vorschau im Finder zeigt rohen Markdown-Quelltext. Das ist am einfachsten, aber weniger lesbar für formatierte Inhalte wie Tabellen, Diagramme und Mathematik.
• Dokumentations-/Static-Site-Toolchain zur Vorschau nutzen: Lokale Dev-Server können Markdown mit vollständiger Site-Formatierung rendern, sind aber typischerweise schwerer als ein Quick-Look-Vorschau-Workflow.