Plugin Anteprima Markdown¶

Un'anteprima dal vivo, affiancata, del documento Markdown attivo, resa in un pannello ancorabile che si aggiorna mentre digiti. Il renderizzatore non ha dipendenze (usa la vista di testo formattato integrata di Qt, non un motore web), quindi questo plugin è sempre disponibile e non aggiunge dipendenze pesanti.

Dove trovarlo¶

Visualizza ▸ Anteprima Markdown apre (o chiude) il pannello di anteprima della scheda corrente. Il pannello preferisce il lato destro e si può trascinare, far fluttuare o mettere a schede come qualsiasi altro pannello.

Come si comporta¶

Resa dal vivo. L'anteprima viene ridisegnata mentre digiti, con un ritardo perché digitare resti scorrevole (il ritardo si allenta automaticamente per i file molto grandi).
Segui il cursore. Con Segui il cursore attivo (barra degli strumenti), l'anteprima scorre fino al blocco che stai modificando appena il cursore passa a un'altra riga. Poiché solo uno spostamento del cursore la fa scorrere, una ricerca porta l'anteprima sulla corrispondenza e poi la lascia stare: puoi scorrere via dalla corrispondenza e l'anteprima resta dove l'hai messa, finché non muovi di nuovo il cursore. Disattiva l'opzione per scorrere l'anteprima in modo del tutto indipendente. L'impostazione viene ricordata.
Adattata al tema. I colori dell'anteprima derivano dal tema attivo dell'editor (testo, blocchi di codice, citazioni, collegamenti), così l'anteprima si intona a un tema chiaro o scuro e si aggiorna dal vivo quando cambi tema. Puoi mettere a punto questi colori nell'Editor dei temi, nelle categorie Markdown.
Esporta / apri nel browser. La barra degli strumenti può esportare l'HTML generato in un file o aprirlo nel tuo browser predefinito. In entrambi i casi ottieni una pagina pulita e autonoma: markup semplice e semantico, senza l'impalcatura che serve al pannello solo per sé, e un foglio di stile chiaro fisso, così il file condiviso si legge normalmente qualunque sia il tuo tema dell'editor.
Dimensione del pannello. L'anteprima mantiene una quota della finestra anziché una larghezza fissa, quindi cresce e si restringe con essa — vedi Disposizione salvata.

Visibilità dell'anteprima¶

La visibilità dell'anteprima viene ricordata per file, sia durante una sessione sia tra i riavvii:

I file Markdown (.md, .markdown, .mdown, .mkd, .mkdn, .mdwn, .markdn, .mdtxt) aprono l'anteprima automaticamente la prima volta che li visualizzi. Questo valore predefinito di «apertura automatica» è un interruttore persistente in Visualizza ▸ Apri automaticamente l'anteprima Markdown.
Gli altri file no, ma puoi aprire l'anteprima su qualsiasi file con Visualizza ▸ Anteprima Markdown, e renderà quel file come Markdown.
Dentro una sessione, ciò che scegli per una scheda viene ripristinato quando vi torni.
Tra i riavvii viene ricordata la tua scelta esplicita per un file: chiudi l'anteprima su un file e resterà chiusa la volta successiva che apri quel file; apri l'anteprima su un file che non si aprirebbe automaticamente e si riaprirà. I file che non hai mai toccato esplicitamente seguono semplicemente ogni volta il valore predefinito di apertura automatica, quindi attivare l'apertura automatica più tardi apre comunque le anteprime che non hai mai chiuso di proposito.

Che cosa rende¶

Formattazione in linea — *corsivo*, **grassetto**, ***grassetto corsivo***, ~~barrato~~, codice in linea e interruzioni di riga forzate.
Titoli — sia nella forma # sia in quella sottolineata (setext).
Elenchi — ordinati e non ordinati, annidati, compatti o spaziati (un elenco spaziato riceve la spaziatura dei paragrafi), a partire dal numero che hai scritto, ed elenchi di attività: - [ ] e - [x] diventano ☐ e ☑.
Tabelle — tabelle con barre verticali e allineamento per colonna (a sinistra, al centro, a destra). Una riga troppo corta viene completata, una cella in più viene scartata e una tabella larga va a capo invece di essere tagliata.
Codice — blocchi delimitati e blocchi indentati allo stesso modo, disegnati in una cornice bordata e riempita con un carattere a larghezza fissa, così un blocco si distingue dal testo e i diagrammi ASCII e le colonne allineate conservano la forma.
Collegamenti e immagini — in linea, per riferimento ([testo][ref] con la definizione in qualunque punto del file) e indirizzi http://, https:// o www. nudi, che diventano collegamenti da sé. I percorsi delle immagini sono risolti rispetto al file.
Citazioni e righe orizzontali.
Front matter YAML — il blocco di metadati --- … --- che alcuni strumenti si aspettano all'inizio del file è mostrato come blocco di codice yaml, non preso per un titolo.

L'HTML grezzo è mostrato come testo, deliberatamente: il markup viene sottoposto a escape invece di essere eseguito, quindi visualizzare in anteprima un documento che non hai scritto tu non può eseguire nulla. I blocchi HTML e le note a piè di pagina non vengono resi.

Quali collegamenti si aprono¶

Fare clic su un collegamento nell'anteprima lo apre solo quando la destinazione è http, https o mailto; un #fragment fa scorrere l'anteprima fino a quel titolo. Ogni altra destinazione — un percorso file:, un percorso semplice o relativo, un indirizzo javascript:, lo schema proprio di qualche applicazione — viene ignorata, e la barra di stato dice quale collegamento non è stato aperto e perché. Il motivo è il documento stesso: un file Markdown che hai clonato o scaricato è il testo di qualcun altro, e un solo clic al suo interno non deve poter avviare un programma sulla tua macchina.

Passare il puntatore su un collegamento mostra dove porta prima che tu faccia clic, con una seconda riga quando è un collegamento che l'anteprima non aprirà.

Vedi anche¶

Anteprima HTML — anteprima a fedeltà piena (CSS/JavaScript) per HTML e PHP, tramite QtWebEngine.
Editor dei temi — regola i colori Markdown dell'anteprima.