showmd

Cos'è showmd?

showmd è un'estensione gratuita Quick Look per macOS che visualizza in anteprima i file Markdown (.md e estensioni correlate) in modo più leggibile rispetto al comportamento predefinito di Finder. Il suo scopo principale è rendere il Markdown con formattazione, mantenendo l'accesso al contenuto sorgente.

Invece di mostrare testo grezzo premendo Spazio su un file .md in Finder, showmd rende il Markdown e fornisce un toggle reso/sorgente. Inoltre, analizza il frontmatter YAML in una tabella di metadati collassabile, supportando flussi di lavoro comuni di documentazione e prompt AI che si basano sulla struttura Markdown.

Caratteristiche Principali

• Anteprima Quick Look per Markdown in Finder: Premi Spazio su un file Markdown per visualizzare l'output formattato senza aprire browser o editor.
• Toggle reso ↔ sorgente: Passa tra Markdown reso e sorgente Markdown grezza con un singolo clic.
• Frontmatter YAML come tabella di metadati collassabile: Rileva le “chiavi trovate” nel frontmatter e le mostra in una tabella collassata per impostazione predefinita.
• Funzionalità Markdown tramite un parser Markdown: Supporta elementi GitHub Flavored Markdown come tabelle, liste di attività, barrato, autolink, note a piè di pagina e altro.
• Rendering syntax-aware per codice e contenuti speciali: I blocchi di codice usano evidenziazione language-aware (190+ linguaggi elencati), matematica LaTeX inline e block rende via KaTeX, e diagrammi Mermaid rendono dai blocchi di codice.
• Rendering tag orientato all'AI: Tag XML-like comuni nei prompt AI (ad esempio, , , ) vengono resi come blocchi etichettati e bordati invece di parentesi angolari grezze.
• Nessun upload cloud o in background descritto: La pagina afferma “No cloud. No uploads. No telemetry”, il che significa che i file vengono visualizzati localmente per impostazione predefinita.
• Gestione immagini inline in Quick Look: I percorsi relativi delle immagini si risolvono correttamente, così screenshot/diagrammi locali appaiono nell'anteprima.

Come Usare showmd

1. Scarica showmd per macOS e aprilo una volta.
2. In Impostazioni di Sistema → Privacy e Sicurezza → Estensioni → Quick Look, abilita showmd (la pagina descrive questo come un singolo toggle).
3. In Finder, seleziona un file Markdown e premi Spazio per visualizzarlo in anteprima con showmd.
4. Usa il toggle reso/sorgente per passare tra output formattato e Markdown sottostante. La pagina nota anche un'opzione per copiare come HTML.

Casi d'Uso

• Lettura documentazione salvata come Markdown: Visualizza in anteprima file README con intestazioni, liste, link e tabelle formattate, senza lasciare Finder.
• Ispezione file prompt/config AI scritti in Markdown: Visualizza file di istruzioni per agent AI dove il contenuto include tag XML-like, con tag resi come blocchi etichettati per scansione più rapida.
• Revisione frontmatter YAML in contenuti static site: Espandi la tabella frontmatter quando devi controllare titoli o chiavi di configurazione, mantenendola collassata durante la lettura casuale.
• Controllo contenuti tecnici con codice, matematica o diagrammi: Vedi blocchi di codice con evidenziazione sintattica, espressioni LaTeX e flowchart Mermaid resi inline invece che come testo grezzo.
• Verifica immagini relative in note/repo docs locali: Conferma che immagini referenziate da percorsi relativi appaiano correttamente nell'anteprima Quick Look.

FAQ

Come abilito showmd in Finder?
Scarica showmd, aprilo una volta, poi vai a Impostazioni di Sistema → Privacy e Sicurezza → Estensioni → Quick Look e abilita l'estensione. Al primo avvio, macOS potrebbe chiedere permesso per accedere a dati da altre app; clicca Consenti.

showmd sostituisce la necessità di aprire un browser?
La pagina presenta showmd come un modo per visualizzare Markdown direttamente in Quick Look di macOS, invece di aprire un browser per vedere l'output reso.

Posso passare tra output reso e Markdown originale?
Sì. showmd fornisce un toggle reso & sorgente, descritto come un singolo clic.

Come gestisce showmd il frontmatter YAML?
Lo analizza in una tabella collassabile, collassata per impostazione predefinita, che puoi espandere per visualizzare i metadati.

C'è un componente cloud?
La pagina afferma “No cloud. No uploads. No telemetry”, indicando che le anteprime sono gestite localmente per impostazione predefinita.

Alternative

• Apri file Markdown in un visualizzatore/editor dedicato per Markdown: Usa un'app progettata per il rendering ed esportazione Markdown. Queste opzioni includono spesso più strumenti di editing, mentre showmd è specificamente un'anteprima Quick Look.
• Usa un renderer Markdown basato su browser: Carica o incolla il contenuto in un visualizzatore online per ottenere l'output reso. Rispetto a showmd, aggiunge un passaggio nel browser e potrebbe non mantenere i file rigorosamente locali.
• Affidati al Quick Look predefinito di macOS: L'anteprima Spazio di Finder mostra la sorgente Markdown grezza. È il più semplice ma meno leggibile per contenuti formattati come tabelle, diagrammi e matematica.
• Usa una toolchain di documentazione/siti statici per l'anteprima: I server di sviluppo locali possono rendere Markdown con stile completo del sito, ma sono tipicamente più pesanti di un flusso di lavoro di anteprima Quick Look.