showmd

showmd – Der beste Weg, Markdown-Dateien auf macOS zu lesen

Markdown wurde nie dafür konzipiert, als reiner Rohtext betrachtet zu werden. Dennoch zeigt die integrierte macOS-Vorschau beim Drücken der Leertaste oft nur ein Durcheinander aus Hashes, Asterisken und Bindestrichen. Hier setzt showmd an. showmd ist die lesbarste Methode, um jede .md-Datei auf macOS in einer ansprechenden, gerenderten Form zu betrachten.

Was ist showmd?

showmd ist ein spezialisierter Markdown-Viewer für macOS, der als Quick Look-Erweiterung fungiert. Es ist kein Editor und keine Notiz-App, sondern ein reiner Betrachter, der darauf ausgelegt ist, Markdown-Inhalte sofort und ohne Ballast anzuzeigen. Während die normale macOS-Vorschau oft an komplexen Strukturen wie Tabellen, Formeln oder Diagrammen scheitert, verwandelt showmd diese in ein sauberes, professionelles Layout.

Egal ob es sich um klassische Dokumentationen oder moderne KI-Dateien wie AGENTS.md oder .cursorrules handelt – showmd sorgt dafür, dass die Inhalte so aussehen, wie sie beabsichtigt waren. Das Tool ist kostenlos, Open Source und wurde speziell für die Anforderungen moderner Workflows entwickelt.

Features von showmd

showmd bietet eine Vielzahl an Funktionen, die weit über herkömmliche Vorschau-Tools hinausgehen:

• Sofortiges Öffnen: Als Standard für .md-Dateien festgelegt, ermöglicht es eine blitzschnelle Vorschau im Finder via Leertaste.
• GitHub Flavored Markdown (GFM): Volle Unterstützung für Tabellen, Aufgabenlisten, Durchstreichungen und Fußnoten, betrieben durch Apples swift-markdown Parser.
• YAML Frontmatter Rendering: Einzigartig bei showmd ist die Verarbeitung von Metadaten. YAML-Blöcke werden als einklappbare Tabellen dargestellt, die standardmäßig minimiert sind.
• Agentic AI XML Tags: Speziell für KI-Prompts werden Tags wie <instructions>, <thinking> oder <example> als umrandete, beschriftete Blöcke gerendert.
• Syntax-Highlighting: Code-Blöcke werden mit sprachspezifischer Hervorhebung für über 190 Sprachen angezeigt.
• LaTeX & Mermaid: Mathematische Formeln via KaTeX und komplexe Mermaid-Diagramme (Flussdiagramme, Sequenzdiagramme) werden direkt in der Vorschau gerendert.
• macOS Nativ: Unterstützt den Dark Mode, System-Schriftarten und fügt sich nahtlos in das Betriebssystem ein.
• Privatsphäre: Keine Cloud, keine Uploads, keine Telemetrie. Alle Dateien bleiben lokal auf Ihrem Rechner.
• Vielseitigkeit: Unterstützt zahlreiche Dateiendungen wie .md, .markdown, .mdx, .mdc, .rmd, .qmd, .mdown, .mkd und .mkdn.

Use Case: Warum showmd nutzen?

Es gibt viele Szenarien, in denen showmd den Arbeitsalltag erleichtert:

1. Entwickler-Dokumentation: Anstatt für jedes README.md VS Code zu öffnen, reicht ein Druck auf die Leertaste, um Tabellen und Code-Beispiele perfekt formatiert zu sehen.
2. KI-Workflow: Wer viel mit KI-Agenten arbeitet, findet in showmd das ideale Werkzeug, um XML-basierte Instruktionen und strukturierte Prompts übersichtlich zu lesen.
3. Wissenschaftliches Arbeiten: Dank der integrierten LaTeX-Unterstützung lassen sich mathematische Ausdrücke in Markdown-Notizen sofort kontrollieren.
4. Projektmanagement: Mermaid-Diagramme und GitHub-Style Alerts (TIP, WARNING, IMPORTANT) machen Projektpläne direkt im Finder greifbar.

Installation und Verwendung

Die Einrichtung von showmd ist denkbar einfach und in wenigen Schritten erledigt:

Schritt 1: Download & Installation

Sie können showmd entweder direkt als signierte .dmg-Datei herunterladen oder bequem via Homebrew installieren: brew install --cask johannesnagl/tap/showmd

Schritt 2: Aktivierung in den Systemeinstellungen

Nach dem ersten Öffnen der App müssen Sie die Erweiterung aktivieren:

1. Gehen Sie zu Systemeinstellungen > Datenschutz & Sicherheit.
2. Wählen Sie Erweiterungen > Quick Look.
3. Aktivieren Sie dort das Häkchen für showmd.

Schritt 3: Nutzung im Finder

Navigieren Sie zu einer beliebigen Markdown-Datei im Finder und drücken Sie die Leertaste. showmd zeigt Ihnen sofort die gerenderte Version an. Über die Schaltflächen am oberen Rand können Sie zudem zwischen der gerenderten Ansicht und dem Quellcode (Source) umschalten oder den Inhalt als HTML kopieren.

FAQ – Häufig gestellte Fragen

Wie aktiviere ich showmd im Finder? Laden Sie die App herunter, öffnen Sie sie einmal und aktivieren Sie sie in den Systemeinstellungen unter Datenschutz & Sicherheit > Erweiterungen > Quick Look. Bestätigen Sie beim ersten Start den Zugriff auf Daten anderer Apps, damit Einstellungen geteilt werden können.

Was passiert mit YAML Frontmatter? showmd parst den --- Block und rendert ihn als einklappbare Metadaten-Tabelle. So bleibt der Fokus auf dem Hauptinhalt, während die Daten bei Bedarf mit einem Klick verfügbar sind.

Kann ich den rohen Markdown-Quellcode sehen? Ja. Jede Vorschau verfügt oben über einen Toggle-Schalter zwischen "Rendered" und "Source".

Unterstützt showmd den Dark Mode? Ja, es folgt automatisch Ihren macOS-Systemeinstellungen, kann aber in den App-Einstellungen auch fest auf Hell oder Dunkel eingestellt werden.

Ist showmd ein Editor? Nein, es ist ein reiner Viewer (Quick Look Erweiterung). Es öffnet Dateien schreibgeschützt, um eine schnelle und saubere Vorschau zu ermöglichen.

Ist das Tool kostenlos? Ja, showmd ist komplett kostenlos und unter der MIT-Lizenz als Open Source auf GitHub verfügbar.