MDViewer visualizza Markdown in due contesti: il lettore nel browser, che apre i file direttamente dal tuo computer, e queste pagine di documentazione. Entrambi usano lo stesso motore di rendering e lo stesso tema, quindi ciò che vedi qui corrisponde esattamente all’aspetto dei tuoi file.
Aprire file locali
Torna alla pagina iniziale del lettore e usa uno di questi metodi:
| Metodo | Come | Ideale per |
|---|---|---|
| Apri una cartella | Fai clic su “Apri cartella” oppure premi O | Leggere un’intera raccolta, con ricerca e collegamenti tra file |
| Apri un file | Fai clic su “Apri un file” oppure premi Shift+O | Leggere un solo documento |
| Trascina e rilascia | Rilascia una cartella o un file .md in un punto qualsiasi della pagina |
Il metodo più rapido |
Nota
I tuoi file non vengono mai caricati su alcun server. Lettura e rendering avvengono interamente nel browser e tutti i dati vengono rilasciati quando chiudi la scheda.
Compatibilità dei browser
L’apertura di una cartella si basa sulla File System Access API :
- Chrome / Edge / Opera 86+: supporto completo, inclusa la memorizzazione dell’ultima cartella aperta
- Safari / Firefox: usa come alternativa
<input webkitdirectory>e il trascinamento. La lettura funziona normalmente, ma il browser non può ricordare la cartella: dovrai selezionarla di nuovo ogni volta.
Ripristino della sessione
Quando apri una cartella in un browser supportato, il relativo handle viene memorizzato in IndexedDB. Alla visita successiva:
- Se l’autorizzazione è ancora valida, torni automaticamente al file e alla posizione di scorrimento lasciati
- Se è scaduta, nell’angolo appare una richiesta “Continua a leggere”; basta un clic per concedere nuovamente l’accesso
L’elenco “Aperti di recente” nella pagina iniziale conserva le ultime 8 aree di lavoro.
L’interfaccia
- Albero dei file a sinistra: si espande per livello di directory; la casella in alto filtra per nome file; B lo comprime
- Contenuto al centro: larghezza, dimensione del testo, interlinea e carattere sono regolabili nelle impostazioni; , le apre
- Indice a destra: generato dai titoli di livello 2–4, evidenzia la sezione corrente durante lo scorrimento; T lo comprime
Tipi di file supportati
Durante l’analisi di una directory il lettore rileva:
- Documenti:
.md.markdown.mdown.mkd.mdx.txt - Immagini:
.png.jpg.gif.svg.webp.avif.bmp.ico(per risolvere i percorsi relativi in Markdown)
Ignora .git, node_modules, dist, build, .obsidian e directory simili, oltre a tutti i file nascosti il cui nome inizia con .. Una singola scansione copre al massimo 6000 file e 12 livelli di profondità.
Percorsi relativi
Immagini e collegamenti scritti in questo modo funzionano tutti:
|
|
Le immagini vengono individuate nell’area di lavoro e trasformate in URL blob locali; i collegamenti .md navigano nel lettore senza ricaricare la pagina. Le destinazioni non trovate vengono evidenziate in rosso con una spiegazione.
Passi successivi
- Esempi della sintassi Markdown : tutte le funzionalità di rendering in una pagina
- Panoramica delle funzionalità : ogni funzione spiegata in dettaglio
- Scorciatoie da tastiera : l’elenco completo