showmd

showmd: De Ultieme Manier om Markdown te Bekijken op macOS

Markdown was nooit bedoeld om als platte tekst bekeken te worden. Wanneer u op een macOS-apparaat op de spatiebalk drukt om een .md-bestand via Quick Look te bekijken, krijgt u vaak een warboel van hashtags, sterretjes en koppeltekens te zien. showmd lost dit probleem op door de meest leesbare en visueel aantrekkelijke manier te bieden om elk Markdown-bestand op macOS te bekijken.

Wat is showmd?

showmd is een gratis, open-source Quick Look-extensie die specifiek is ontworpen voor de manier waarop Markdown tegenwoordig wordt gebruikt. Het is geen editor of notitie-app, maar een pure viewer die zich richt op snelheid en leesbaarheid. Of het nu gaat om technische documentatie, AI-instructiebestanden zoals CLAUDE.md, of complexe diagrammen, showmd rendert ze direct in uw Finder zonder dat u een browser of zware teksteditor hoeft te openen.

Het project is 'Made in Vienna' en biedt een privacy-eerst benadering: uw bestanden verlaten nooit uw machine, er is geen cloud-integratie en geen telemetrie.

Belangrijkste Kenmerken van showmd

showmd onderscheidt zich door een uitgebreide set functies die verder gaan dan de standaard Markdown-weergave:

• Directe Weergave: Stel showmd in als standaard voor .md-bestanden en gebruik de spatiebalk voor een directe preview zonder frictie.
• GitHub Flavored Markdown (GFM): Volledige ondersteuning voor tabellen, takenlijsten, doorhalingen en automatische links.
• YAML Frontmatter Parsing: Uniek aan showmd is dat YAML-metadata wordt omgezet in een inklapbare tabel. Standaard is deze ingeklapt zodat het niet in de weg zit.
• AI Agent Tags: Speciaal gebouwd voor moderne AI-workflows. XML-tags zoals <instructions>, <thinking> en <example> worden gerenderd als gelabelde, omkaderde blokken.
• Syntax Highlighting: Ondersteuning voor meer dan 190 talen in codeblokken.
• Wiskunde en Diagrammen: Prachtige weergave van LaTeX-wiskunde via KaTeX en Mermaid-diagrammen (stroomdiagrammen, sequentiële diagrammen, etc.) direct in de preview.
• Native macOS Ervaring: Respecteert systeemlettertypen, ondersteunt Dark Mode volledig en voelt aan als een integraal onderdeel van het besturingssysteem.
• Ondersteuning voor vele extensies: Werkt met .md, .markdown, .mdx, .mdc, .rmd, .qmd, .mdown, .mkd en .mkdn.

Hoe Gebruik Je showmd?

Het installeren en activeren van showmd is een eenvoudig proces van drie stappen:

1. Downloaden & Openen: Download het .dmg-bestand of installeer via Homebrew met het commando: brew install --cask johannesnagl/tap/showmd.
2. Inschakelen in Systeeminstellingen: Ga naar Privacy & Beveiliging → Extensies → Quick Look en vink showmd aan.
3. Spatiebalk in Finder: Selecteer een Markdown-bestand en druk op de spatiebalk. De gerenderde weergave verschijnt direct.

Tip: Bij de eerste start zal macOS vragen om toegang tot gegevens van andere apps. Klik op 'Sta toe' zodat de app en de extensie uw instellingen kunnen delen.

Gebruiksscenario's (Use Cases)

Ontwikkelaars en Engineers

Voor ontwikkelaars die snel een README.md of CHANGELOG.md willen scannen zonder hun IDE te openen. Met de ingebouwde syntax highlighting en ondersteuning voor Mermaid-diagrammen is technische documentatie direct leesbaar.

AI-Specialisten

Bij het werken met AI-agents (zoals met AGENTS.md of .cursorrules) zijn bestanden vaak gevuld met XML-tags. showmd is de enige viewer die deze tags netjes vormgeeft in plaats van ze als ruwe tekst te tonen.

Academici en Schrijvers

Dankzij de ondersteuning voor LaTeX en verschillende Markdown-smaken zoals R Markdown (.rmd) en Quarto (.qmd), kunnen wetenschappers snel hun formules en data-notities controleren.

Veelgestelde Vragen (FAQ)

V: Hoe schakel ik showmd in Finder in? A: Download de app, open deze eenmalig, en ga dan naar Systeeminstellingen → Privacy & Beveiliging → Extensies → Quick Look om de extensie te activeren.

V: Kan ik de ruwe Markdown-broncode nog steeds zien? A: Ja. Er is een handige 'Rendered / Source' toggle bovenaan elke preview. U kunt ook de inhoud direct als HTML kopiëren vanuit de gerenderde weergave.

V: Is showmd een editor? A: Nee, het is uitsluitend een viewer (Quick Look-extensie). Het opent bestanden in 'read-only' modus om ze snel te presenteren.

V: Werkt showmd offline? A: Ja, alles wordt lokaal op uw machine gerenderd. Er is geen internetverbinding nodig voor het weergeven van Markdown, wiskunde of diagrammen.

V: Is showmd gratis? A: Ja, showmd is volledig gratis en open-source onder de MIT-licentie. Als u het project waardeert, kunt u de ontwikkelaar optioneel ondersteunen met een 'pasta' (donatie).