Markdown e wikilink

Modalità di visualizzazione

Le note .md si aprono con editor e lettura affiancati (configurabile). Il markup viene attenuato fuori dal paragrafo del cursore così la pagina sembra un documento finito.

Scorciatoie: Ctrl+B/Ctrl+I applicano grassetto/corsivo e Ctrl+E alterna la modalità di visualizzazione (editor → diviso → formattata → lettura).

Il menu /: nell'editor formattato digita / a inizio riga (anche con rientro) o dopo uno spazio: l'elenco di inserimento si apre al cursore. Digita per filtrare (/tabella, /riquadro, /h1), scegli con ↑/↓ e inserisci con Invio; Esc o Spazio chiudono l'elenco e ciò che hai digitato resta come testo. La colonna di destra mostra il markup che ogni voce scrive, così la prossima volta puoi digitarlo direttamente. Il menu non si apre dentro un blocco di codice, una formula o una cella di tabella.

Modalità di lettura: l'ultima modalità di Ctrl+E è la stessa schermata della modifica formattata, ma di sola lettura — ed è per questo che può mostrare ciò che il file non ha: il sommario del token [TOC]. L'elenco della cartella del token [files] e il corpo delle note transcluse con ![[nota]] compaiono anche nella modifica formattata. Nulla di tutto ciò viene scritto nel .md: il file conserva il token e il testo generato non accetta modifiche. In questa modalità un clic semplice segue link, wikilink ed etichette (senza Ctrl), e i pulsanti che modificano restano disabilitati — compresi annulla, taglia e incolla, che prima agivano sull'editor di testo fuori dallo schermo. Copia continua a valere e copia ciò che stai vedendo. Ctrl+F cerca in ciò che è sullo schermo; la riga sostituisci resta disabilitata, con il motivo nel tooltip, perché una sostituzione qui non arriverebbe al file.

Conti con unità, in lettura. Una riga che finisce con = riceve il risultato: 3,5 km / 2 s = appare come 3,5 km / 2 s = 1,75 km/s. Il file non cambia: è la stessa idea del [TOC] e della citazione formattata. Fa analisi dimensionale, ed è lì che si giustifica: 1 km + 1 s = viene rifiutato nominando entrambi, perché una calcolatrice che rispondesse 2 non sarebbe peggiore: sarebbe una che mente, e in un quaderno di laboratorio l'errore sopravvivrebbe fino all'articolo. Sommare la stessa grandezza in unità diverse funziona e converte (2 h + 30 min =), e il risultato esce nell'unità che hai scritto. Conosce i prefissi SI, le costanti fisiche (c, h, k_B, N_A, g…), la conversione esplicita (3 km in m, anche to e ->) e l'incertezza: (2,00 ± 0,05) m / (1,0 ± 0,1) s = propaga l'errore e scrive solo le cifre che la misura permette. Codice e formule restano fuori: dentro un recinto ```, tra apici inversi o in un $…$, il = a fine riga è sintassi di altro. E una riga che non è un conto (Totale =) resta com'è, in silenzio.

Arriva disattivata: attivala in Impostazioni → Funzionalità → Accademico → Calcolatrice con unità.

Carte a ripetizione dilazionata. Una nota che riceve l'etichetta #flashcards diventa un mazzo: al suo interno, ogni riga Domanda::Risposta è una carta, ::: crea anche la carta inversa, un ? da solo fra due righe fa la carta su più righe e ==così== diventa una lacuna. Senza l'etichetta, nessuna nota ha carte: è ciò che impedisce a uno std::vector di una nota di programmazione di diventare una carta che non hai scritto. Strumenti → Carte → Ripassa le carte apre la sessione: la risposta resta nascosta finché non la chiedi (è tutto il senso del ripasso — vedere le due insieme è rileggere, e rileggere non fissa niente), e le quattro valutazioni portano scritto sopra quanto tempo compra ciascuna. La pianificazione è FSRS, lo stesso algoritmo di Anki.

L'identità della carta è la DOMANDA: correggere la risposta non tocca la pianificazione, e riscrivere la domanda manda in pensione quella carta e ne comincia un'altra — ed è giusto così, perché la domanda è ciò che stai imparando. Lo storico vive in un file aperto accanto alla nota (nota.md.cards.ndjson): versionabile con Git e leggibile in qualsiasi editor, al prezzo di un file in più nella cartella. Esporta in Anki scrive il file di testo che lui importa: la pianificazione non va insieme, perché l'importatore di testo di Anki non la accetta; resta nei .ndjson.

Blocchi di codice

Il blocco di codice esce colorato. Un recinto con il linguaggio dichiarato (```python) ha il contenuto evidenziato token per token, con gli stessi colori dell'editor di codice — compreso il tema di codice scelto per questa finestra. Vale nella modifica formattata, nella modalità di lettura, nel file esportato e nelle risposte di Chiedi alle note. Un recinto senza linguaggio dichiarato resta monocromatico, e anche un linguaggio senza evidenziazione disponibile: il testo non smette mai di comparire.

Piegare, fissare ed esportare

Piegare le sezioni e fissare il titolo valgono anche in modalità formattata e di lettura. Ctrl+Shift+[ comprime la sezione del cursore e Ctrl+Shift+] la espande; fare clic sulla freccetta a sinistra del titolo fa lo stesso, e Visualizza → Comprimi tutte le intestazioni / Espandi tutte le intestazioni agisce sulla superficie in primo piano. Mentre scorri, le intestazioni uscite in alto restano fissate in una fascia — fai clic su una per saltare alla sua sezione. Piegare è stato di schermo: il .md non cambia e il testo compresso resta nel file.

Esportare: il PDF e l'HTML sono generati dallo stesso documento della modalità di lettura: il file ottenuto è ciò che hai appena letto, con sommario, elenco della cartella e transclusioni. L'HTML è autonomo (le immagini locali vengono incorporate) e il PDF ha testo vettoriale, quindi resta ricercabile. L'HTML esce con marcatura semantica — titolo con ancora, callout in <aside>, tabella con intestazione, nota a piè di pagina con ritorno — e le formule in MathML: testo vero, che si copia, si legge ad alta voce e non sgrana con lo zoom. Il tema segue ciascun formato: l'HTML mantiene i colori che vedi a schermo, tema scuro incluso (il file ha uno sfondo proprio); il PDF va sempre su carta chiara, perché è pensato per essere stampato e inviato: se il tuo tema di contenuto è scuro viene stampato con il tema chiaro predefinito, mentre un tema chiaro che già usi viene conservato. Word, OpenDocument, LaTeX, Typst ed EPUB li genera LightNote stesso, senza installare nulla.

Il .docx e l'.odt escono con titoli, elenchi, tabelle, note a piè di pagina, immagini e le formule come equazioni modificabili: di Word nell'uno, di LibreOffice Math nell'altro; il .tex ha un preambolo completo e compila con pdfLaTeX, XeLaTeX e LuaLaTeX. Se la cartella ha una bibliografia e la sezione Accademico è attiva, il .tex esce con la citazione viva: [@chiave] diventa \autocite, il token [bibliography] diventa \printbibliography e un refs.bib con le opere citate viene salvato accanto — l'app te lo dice. Compila con biber.

Il .typ è la stessa idea in Typst, che compila in pochi secondi senza una distribuzione LaTeX installata: la formula viaggia in LaTeX tramite il pacchetto mitex (scaricato alla prima compilazione) e la citazione esce come @chiave con #bibliography.

L'.epub è il libro elettronico: un capitolo per titolo di livello 1, sommario di navigazione, immagini come file del pacchetto e la stessa marcatura semantica dell'HTML. L'.ipynb è il notebook Jupyter: la prosa diventa cella di testo e il blocco nel linguaggio del kernel diventa cella di codice — solo quello, perché una cella di codice viene mandata al kernel, e un diagramma Mermaid trasformato in cella verrebbe eseguito come Python alla prima esecuzione. Il kernel esce dalla chiave kernel nelle proprietà della nota, o dal blocco più frequente.

L'output non viene inventato: le celle escono senza risultato, perché un risultato viene da un'esecuzione — la stessa regola che l'importazione di notebook già segue scartando gli output salvati. E c'è Markdown per…: la stessa nota nel dialetto della destinazione — avviso > [!NOTE] su GitHub, !!! note su MkDocs, :::note su Docusaurus, ::: {.note} su Pandoc, la grafia di Obsidian o CommonMark stretto.

Il wikilink diventa link relativo (fuori da Obsidian) e il commento %%…%% non viene pubblicato, perché è privato. Con Typst installato (winget install --id Typst.Typst), l'esportazione offre Compila il PDF lì stesso; senza, il pulsante diventa Installa Typst..., che apre la guida. Se il corso o il cliente fornisce un modello Word, indica il suo .docx in Configurazione dello spazio di lavoro → Citazioni e riferimenti → Modello Word: il file esportato esce con stili, formato carta, margini e intestazione del modello. Una nota può usarne un altro dichiarando reference-docx: modello.docx nelle sue proprietà. Tutti e tre partono dal Markdown della lettura — citazioni già formattate, figure numerate — e ciò che non passa viene segnalato alla fine dell'esportazione. La compilazione avviene in background, come un'operazione del pannello Operazioni: la finestra continua a rispondere e Interrompi la ferma.

Il diagramma Mermaid e la struttura chimica entrano come immagine — disegnati su carta chiara nel .docx, nell'.odt e nell'EPUB, con i colori dello schermo nell'HTML —; solo tramite lnote, che non ha una finestra per disegnarli, escono come blocco di codice. E c'è Testo marcato per…: reStructuredText, AsciiDoc, Org mode, MediaWiki e testo semplice, scritti anch'essi da LightNote. Ognuno riceve la propria costruzione nativa, e non un'imitazione: il riquadro diventa .. note:: in Sphinx, [NOTE] in AsciiDoc e #+begin_note in Org; la formula diventa .. math::, latexmath:[], LaTeX puro e <math>; la nota a piè di pagina diventa footnote:[] e <ref>. Il testo semplice non porta alcuna marcatura — la tabella esce allineata in colonne, per stare in un'e-mail o in un messaggio di commit. Ciò che la destinazione non ha viene segnalato alla fine: MediaWiki non ha il riquadro di avviso nel suo nucleo (diventa una citazione con l'etichetta in grassetto) e reStructuredText non ha il testo barrato. Per portare via un pezzo senza scrivere un file, il menu contestuale dell'editor ha Copia la selezione come (o Copia la nota come, senza selezione): testo formattato da incollare in Word, Google Docs o un'e-mail, Markdown di GitHub, LaTeX e Typst. LaTeX e Typst portano solo il corpo — niente preambolo né titolo —, perché la destinazione è un documento che li ha già; il pacchetto di cui il pezzo ha bisogno e la citazione che dipende dalla bibliografia della destinazione vengono segnalati nella barra di stato, e anche il commento %%…%% resta fuori.

L'RTF sta in Altri formati (pandoc) e passa da pandoc, un programma a parte (winget install --id JohnMacFarlane.Pandoc): senza di esso questa destinazione appare disattivata, con il motivo, e Installa pandoc... nello stesso sottomenu apre la guida ed esegue l'installazione. Se pandoc è già installato altrove, indica il file con Ce l'ho già: individua sul disco... nella guida, oppure in Impostazioni → Strumenti di codice → Programmi esterni.

Esporta con opzioni... è la prima voce del menu di esportazione — quello della scheda e quello di File → Esporta nota sono lo stesso menu. Elenca tutte le destinazioni, con una ricerca che trova nome, uso ed estensione (wiki trova MediaWiki, sphinx trova reStructuredText), e mostra solo le opzioni valide per la destinazione scelta: Indice all'inizio, quando la nota non ha ancora un [TOC]; Lingua del documento, che decide la sillabazione e le etichette che il documento genera da sé; Citazioni vive o risolte nel testo, in LaTeX e Typst; il Modello Word, con la casella che lo rende il predefinito della cartella; le Formule di HTML ed EPUB in MathML o come immagine, per lettori di e-book datati o HTML incollato in un'e-mail; la Carta del PDF, A4 o Letter; e Compila il PDF con Typst subito dopo. Un'opzione valida ma non utilizzabile resta disattivata con il motivo — citazioni vive senza bibliografia nella cartella —, e una destinazione che dipende da un programma assente ne offre l'installazione lì stesso. L'ultima scelta viene ricordata per cartella e la finestra si riapre come l'avete lasciata; le voci dirette del menu continuano a esportare con i valori di fabbrica, così una scelta fatta settimane prima non cambia il file di una scorciatoia. Il [TOC] scritto nella nota vale in tutte le destinazioni: diventa l'indice di Word e LibreOffice (Word lo aggiorna all'apertura), \tableofcontents in LaTeX, #outline() in Typst e l'elenco di link in HTML e Markdown. Nel testo formattato di Copia la selezione come, formula e diagramma vanno come immagine, con la sorgente LaTeX come testo alternativo: lì non si sa dove il testo verrà incollato, e solo un'immagine appare uguale in Word, Google Docs e in un'e-mail — chi ha bisogno dell'equazione modificabile esporti il .docx o l'.odt.

Esce anche la cartella intera: File → Esportare la cartella... (o il tasto destro su una cartella dell'albero) trasforma le sue note in un sito HTML — una pagina per nota, con un indice quando nessuna nota è già diventata index.html —, in un insieme di .docx o .odt, o in un albero di Markdown nel dialetto della destinazione. La struttura di sottocartelle è preservata, i link e i wikilink fra le note puntano ai file usciti (anche in Word e LibreOffice, da un documento all'altro) e le immagini e gli allegati che vivono dentro la cartella vanno insieme, nello stesso posto. Ciò che è fuori non viene copiato: resta come lei l'ha scritto, e il rapporto finale elenca ogni caso, insieme ai link senza destinazione. La cartella di destinazione deve essere vuota — oppure spunti Sostituire i file con lo stesso nome — e non può contenere la cartella esportata. Senza finestra: lnote folder-export --path . --format html --out site, e lo strumento folder_export via MCP; lì la trasclusione, il [files] e la numerazione delle figure non vengono risolti, perché a risolverli è la finestra.

Modifica formattata

Modifica formattata (WYSIWYG): la quarta modalità mostra la nota com'è resa — titolo con corpo da titolo, elenco con il suo punto, tabella come griglia e immagine dentro il testo — invece della marcatura. Il file resta lo stesso .md: a scriverlo è LightNote, non Qt, ed è per questo che grassetto, corsivo, wikilink, transclusione e riquadri sopravvivono all'andata e ritorno. Entrare nella modalità e uscirne senza modificare non cambia un byte del file. La barra offre solo ciò che il Markdown rappresenta — titolo, grassetto, corsivo, barrato, codice, elenchi (con casella di attività), citazione, collegamento, tabella e linea orizzontale; allineamento, rientro e dimensione del carattere restano fuori perché andrebbero persi al salvataggio.

Dentro una tabella, Tab passa di cella e crea la riga successiva sull'ultima. Invio nel vuoto accanto alla tabella — dove cade il cursore facendo clic a destra di una riga — aggiunge una riga in fondo, con il cursore nella prima cella. Dentro una cella, Invio spezza la riga lì (va nel file come <br>, l'unica forma che la tabella Markdown accetta) e Ctrl+Invio crea la riga sotto, con il cursore nella stessa colonna. Passando il mouse sulla tabella compaiono maniglie discrete: a sinistra della riga, una coppia di frecce che la sposta in alto o in basso — e che si può anche trascinare per portarla altrove; sopra la colonna, la coppia che la sposta di lato; e un + sul bordo inferiore e un altro su quello destro, che aggiungono riga e colonna. La prima riga è l'intestazione e non si sposta. Tutto questo è anche nel menu contestuale, in Tabella — che porta anche Rimuovi la tabella, il modo sicuro di toglierla tutta.

In un riquadro (<details> o :::), l'ultima riga chiude il riquadro e non si cancella: è ciò che impedisce al contenuto sotto di finirci dentro. Per disfarlo mantenendo il testo, usa Rimuovi il riquadro nel menu contestuale. Invio crea sempre una riga. In un elemento di elenco vuoto esce dall'elenco senza aggiungere righe — come in Word — e in un paragrafo vuoto crea la riga vuota. Una riga vuota del file è la separazione normale fra paragrafi e non appare come riga vuota; dalla seconda in poi sì, e torna nel file com'è stata scritta.

Trascinare il bordo destro di un'immagine la ridimensiona, e la larghezza va nel file come ![alt|300](foto.png). La barra ha dodici controlli: grassetto, corsivo e titolo diretti, più due menu che dividono il resto per quello che fanno — Formatta agisce su ciò che è già scritto (marcature, elenchi, citazione, allineamento della tabella e le operazioni di Testo) e Inserisci crea qualcosa di nuovo (collegamento, immagine, tabella, blocco, diagramma, formula, riquadro). Formattare la tabella e il menu Testo restano dell’editor di testo: qui appaiono disattivati, con il motivo. Attenuare la marcatura è passato al pulsante Visualizzazione, accanto alla colonna di lettura e allo scorrimento a macchina da scrivere, che valgono in tutte e quattro le modalità. E il menu Inserisci offre qui le stesse voci dell’editor di testo — evidenziazione, apice, pedice, wikilink, nota a piè di pagina, riquadro (callout), blocco comprimibile, sommario ed elenco di definizioni —, tutto ciò che questa modalità sapeva già mostrare e non sapeva creare.

Quello che mostra la modalità di lettura, ora lo mostra anche la modifica formattata. L'emoji :fire: appare come 🔥, ==evidenziato== come un segno giallo, ^2^ e ~2~ come apice e pedice, #etichetta come una pillola e un indirizzo web nudo come un collegamento. Il file conserva la forma scritta: aprire la nota non riscrive nulla. Modificare dentro un frammento rappresentato conserva la marcatura — scrivere in mezzo a un evidenziato continua a evidenziare — e ciò che si scrive subito dopo resta fuori. Il commento %%…%% resta visibile, attenuato: nasconderlo lo renderebbe invisibile e non modificabile.

I callout diventano una scatola anche nella modifica formattata. Una citazione che inizia con > [!NOTE] — o [!TIP], [!IMPORTANT], [!WARNING], [!CAUTION] — appare con barra e titolo colorati, come nella modalità di lettura: il marcatore lascia il posto all'etichetta del tipo, o al tuo titolo quando scrivi > [!TIP] Il mio titolo. Il file conserva il marcatore scritto, e modificare il titolo preserva il tipo del callout. Anche i nomi di riquadro di Obsidian e di MkDocs sono compresi: [!SUCCESS], [!ABSTRACT], [!FAILURE], [!QUESTION] e i loro alias (tldr, missing, faq) finiscono nel riquadro più vicino, così una nota arrivata da lì appare già colorata — e, esportando, ogni destinazione riceve il nome che conosce.

Questa è la modalità predefinita su un’installazione nuova. Chi usava già LightNote mantiene la modalità precedente; per cambiarla, usa Impostazioni → Generale → Vista iniziale di Markdown. Facendo clic su un titolo nella Struttura il salto avviene all’interno della modalità corrente, senza farti uscire dalla modifica formattata né dalla lettura.

Allineare la colonna di una tabella. Con il cursore dentro la tabella, il menu contestuale offre Tabella → Allinea colonna: A sinistra, Centrato, A destra o Predefinito. L'allineamento riguarda la colonna intera — è così che Markdown lo rappresenta — e finisce nel file sulla riga separatrice (:--, :-:, --:); Predefinito torna a ---. Il segno di spunta nel menu dice quale è in vigore: sullo schermo una colonna --- e una :-- si somigliano.

La Struttura mostra ciò che è sullo schermo. L'elenco dei titoli viene dalla superficie che stai guardando: nella modifica formattata un titolo appena scritto compare subito, senza aspettare che il testo arrivi all'editor di testo; nella modalità di lettura include anche i titoli delle note incluse con ![[nota]], che fanno parte di ciò che leggi. Fare clic su una voce porta al titolo giusto in entrambi i casi. E nella modalità divisa lo scorrimento è ora a doppio senso: scorrere la lettura porta con sé l'editor di testo, come già accadeva nel verso opposto.

La marcatura diventa formato mentre digiti. Scrivere **prova** applica il grassetto e toglie gli asterischi; lo stesso vale per *corsivo*, ~~barrato~~, `codice` e le forme con trattino basso. A inizio riga, da #  a ######  diventano titoli, -  e 1.  elenchi (il numero digitato è l'inizio), - [ ]  attività con casella, >  citazione, e --- da solo diventa una linea orizzontale premendo Invio. I marcatori che disegnano qualcosa valgono già sullo spazio; solo il titolo aspetta la prima lettera, perché un titolo vuoto non mostrerebbe nulla.

Ctrl+Z annulla solo la conversione e riporta la marcatura letterale — la via d'uscita per chi voleva davvero gli asterischi. Anche incollare converte: un testo con marcatura incollato entra formattato, senza i marcatori. Qui la regola è più prudente che nella digitazione — scatta solo con marcatura inequivocabile — perché incollando non vedi il risultato formarsi: così un frammento di codice, pieno di * e _, resta codice. Dentro un blocco di codice non si converte nulla, perché lì la marcatura è l'argomento. Per disattivare tutto: Impostazioni → Generale → Converti la marcatura mentre digiti.

Da Word, da Google Docs o da una pagina, quello che arriva è il testo con la sua struttura: titolo, elenco (compreso quello di Word, che sotto non è un elenco), tabella, collegamento, codice nella riga e blocco di codice con il linguaggio. Il carattere, la dimensione e il colore dell'origine restano fuori: il Markdown non li rappresenta, e tenerli lascerebbe un tratto in Arial blu che sparisce al salvataggio. L'immagine che arriva insieme diventa un allegato della nota quando Word o il browser l'hanno lasciata nella cartella temporanea, che si svuota da sola; quella che punta a internet continua a puntarci, e il suo menu contestuale offre Scarica l’immagine nello spazio di lavoro.

Immagini, link e wikilink

Immagine e collegamento. Ci sono tre strade per inserire un'immagine: Inserisci → Immagine… nella barra, digitare ![](foto.png), oppure trascinare il file dentro la nota — un'immagine inserisce l'immagine, una nota .md inserisce un [[wikilink]], e ogni altro file diventa un collegamento con il nome del file come etichetta — e trascinandone diversi insieme, ognuno va sulla sua riga. Il percorso salvato è relativo alla cartella della nota quando possibile, così la nota continua a funzionare dopo aver spostato il vault. L'indirizzo di un collegamento non compare nel testo (si vede l'etichetta), quindi appare nella barra di stato al passaggio del mouse, e Ctrl+clic lo apre: un indirizzo web va al browser, un percorso locale si apre in LightNote.

Modificare un collegamento già fatto: mettici il cursore e usa il pulsante Collegamento (o Modifica collegamento… nel menu contestuale) — la finestra si apre con testo e indirizzo già compilati. Il menu contestuale su un collegamento offre anche Copia indirizzo e Rimuovi il collegamento, che lo disfa lasciando il testo. Su un [[wikilink]] offre Apri la nota e Copia la destinazione; su un'#etichetta, Cerca l'etichetta e Copia l'etichetta. Su un'immagine c'è Testo alternativo… — invisibile nella modalità formattata, ma va nel file e nella ricerca — e, dopo aver trascinato la maniglia, Dimensione originale, che restituisce all'immagine la sua misura. Su un'immagine con indirizzo web compare Scarica l'immagine nello spazio di lavoro: il file va in Allegati/ accanto alla nota e la nota punta lì — altrimenti dipenderebbe dall'esistenza di quella URL. E c'è la via più breve di tutte: seleziona un testo e incolla un indirizzo — diventa [testo](indirizzo) invece di sostituire la selezione. Vale in entrambe le superfici di modifica. Finché non viene scaricata, l'immagine dal web compare come una scheda con l'indirizzo e il percorso del menu — LightNote non va in rete per rendere una nota, e prima lì restava il riquadro vuoto dell'immagine rotta, senza dire cosa fare.

E la marcatura si può annullare. Nel menu Formato le voci Evidenziazione, Apice e Pedice appaiono spuntate quando il cursore è dentro una di esse, e farci clic toglie la marcatura invece di applicarla di nuovo. Da tastiera c'è la via rapida: con il cursore alla fine di un tratto formattato, Ctrl+Shift+Backspace restituisce la marcatura letterale meno un carattere — grassetto diventa **grassetto* come testo normale — e completare il delimitatore mancante la ricrea. Vale per grassetto, corsivo, barrato, codice, evidenziazione, apice e pedice. Il Backspace da solo cancella una lettera, lì come altrove.

Modificare il diagramma senza uscire dalla nota. Un diagramma Mermaid o una formula $$…$$ compaiono disegnati nell'editor formattato; per raggiungere la sorgente, porta il cursore sopra e premi Ctrl+Invio — oppure usa Modifica questo blocco… nel menu contestuale. La barra in basso mostra il testo, la nota resta bloccata finché è aperta, e chiuderla (✕, Esc, Ctrl+Invio, un clic sulla nota) applica: la via di ritorno è Ctrl+Z. Nello stesso menu, Estrai in una nuova nota… scrive il tratto selezionato in una nota accanto a questa e lascia al suo posto un [[wikilink]] — la marcatura viene con lui, quindi titolo, elenco e tabella arrivano interi nella nota nuova. Il campo mostra solo il contenuto: le righe ```mermaid e ``` (o i $$) sono diventate il selettore di tipo nell’intestazione della barra, che alterna anche tra diagramma, formula e blocco di codice. L’Invio mantiene il rientro della riga, che in un linguaggio rientrato come Mermaid è il gesto di ogni riga. E il menu contestuale del blocco offre Copia il codice Markdown e Copia l’immagine — il codice si incolla in qualsiasi editor Markdown e torna a disegnarsi; l’immagine si incolla in una e-mail o in una chat. Entrambi valgono anche in sola lettura.

Chiedere la modifica all'IA. Con la barra del blocco aperta, il pulsante IA nell'intestazione apre una riga in cui scrivi cosa cambiare — «aggiungi un percorso di errore che torna all'inizio», «sostituisci la somma con un integrale» — e Invio la invia. Accanto al campo, un pulsante mostra quale IA risponderà: il suo menu cambia assistente solo per questo blocco, senza toccare la tua IA predefinita, e contiene Vedi cosa verrà inviato. Vale la pena guardarlo, perché l'IA riceve il blocco, il titolo e la sezione della nota e il testo attorno — è questo che permette di chiedere che il diagramma rifletta quanto è scritto lì. La risposta entra nel campo e il disegno viene rifatto subito: Ctrl+Z riporta quello che avevi scritto. LightNote verifica la risposta con il proprio renderer e, quando non disegna, chiede una correzione indicando al modello la riga e il comando rifiutati — se fallisce anche quella, scrive la risposta lo stesso e lascia il motivo sulla barra, così sistemi le due righe a mano. Il pulsante compare solo su diagramma, formula e struttura chimica.

Puntare a una sezione, ed etichettare dalle proprietà. [[Nota#Sezione]] apre la nota a quella sezione — l'ancora nomina il testo del titolo — e ![[Nota#Sezione]] include solo quella (fino al titolo successivo di livello uguale o superiore, sottotitoli compresi). Un'ancora che non corrisponde a nessun titolo lo dice nella barra di stato, e l'inclusione resta com'è scritta: portare lì la nota intera sarebbe consegnare un'altra cosa in silenzio. E le tags: del frontmatter ora contano come etichette della nota, in entrambe le grafie (tags: [a, b] e l'elenco su righe proprie) — arrivano alle Basi, alla ricerca per etichetta e a quello che vede l'assistente, insieme alle #etichette del corpo. Senza il nome della nota, l'ancora punta alla nota stessa: [[#Conclusione]] salta a quella sezione senza aprire nessuna scheda, e ![[#Conclusione]] porta la sezione dove sei. E le ancore si annidano: [[Tesi#Metodo#Campione]] è il Campione dentro Metodo, non il primo con quel nome nella nota. La terza forma punta a un blocco: una riga che finisce con ^id (o un ^id da solo subito sotto il blocco) è la destinazione di [[Nota#^id]]. LightNote non crea quegli identificatori: ti porta a quello che hai scritto. E l'ancora di una destinazione che non è una nota è l'indirizzo dentro di essa: [[articolo.pdf#page=3]] apre il PDF a quella pagina.

Wikilink: digita [[ per l'autocompletamento con le note dello spazio di lavoro; il link si chiude da solo con ]]. Tieni premuto Ctrl e clicca su un [[nota]] per aprire la nota corrispondente. Il pannello Collegamenti mostra le connessioni tra le note. Anche la figura incorporata di Obsidian appare: ![[foto.png]] viene disegnata come immagine, e ![[foto.png|300]] rispetta la larghezza. Il file conserva quello che hai scritto: il percorso dell'immagine non viene mai salvato al posto del token.

E l’allegato che non è un’immagine diventa una scheda: ![[articolo.pdf#page=3]], ![[lezione.ogg]] e ![[mappa.canvas]] compaiono come un riquadro con il nome del file, cliccabile — e il PDF si apre alla pagina che lei ha indicato. Il .canvas e il .base di Obsidian hanno una riga in più, che dice che il file resta nella cartella e che LightNote non lo disegna. Un bersaglio che non esiste resta come lei l’ha scritto: una scheda lì prometterebbe un file perduto. A metà di una frase, la figura appare allo stesso modo e l’allegato diventa solo il nome del file, che Ctrl+clic apre: un riquadro lì spezzerebbe il paragrafo. La stessa nota con un altro nome: scriva aliases: [Campionamento, Metodo di campione] nelle proprietà della nota e [[Campionamento]] la apre — l’alias entra anche nel completamento automatico di [[. Un file con quel nome vince sempre sull’alias. Gli alias vengono dall’indice della cartella, che l’app ricostruisce in secondo piano all’apertura dello spazio di lavoro: un aliases: appena scritto si risolve alla scansione successiva, non nello stesso secondo.

Pannello Etichette

Il pannello Etichette. La striscia della barra laterale ha una sezione Etichette: l'albero di tutte le #etichette delle tue note, annidate per / (#progetto/alfa e #progetto/beta diventano rami di progetto), con il numero di note accanto — contate per nota, non per occorrenza. Selezionando un'etichetta compaiono sotto le note che la portano (un genitore mostra anche quelle dei suoi rami); doppio clic apre la nota. Il pannello legge l'indice, quindi vede entrambe le fonti: le #etichette nel corpo e i tags: nel frontmatter. Ctrl+clic su un'etichetta dentro una nota apre questo pannello con quella selezionata — prima apriva la ricerca testuale di #etichetta, che non trova la nota che la dichiara nel frontmatter. Per l'occorrenza letterale nel testo, resta la ricerca globale.

Riquadri, note a piè di pagina e marcatura avanzata

Lettura ricca: i blocchi di codice recintati appaiono in un riquadro con l'etichetta del linguaggio e un link per copiare; ~~barrato~~ e ==evidenziato== vengono renderizzati; e i callout in stile GitHub (> [!NOTE], [!TIP], [!WARNING], [!IMPORTANT], [!CAUTION]) diventano riquadri colorati. I tag #hashtag sono evidenziati e, con Ctrl+clic, aprono una ricerca per quel tag; il blocco frontmatter YAML in cima (---) è evidenziato. Sulla barra degli strumenti della scheda c'è un pulsante per esportare la nota come PDF/HTML, una colonna di lettura centrata attivabile e le modalità di visualizzazione della nota. La modalità Zen (F11) e lo scorrimento a macchina da scrivere aiutano a scrivere senza distrazioni.

Le note a piè di pagina saltano in entrambe le direzioni. Il riferimento [^1] appare come un numero in apice, e Ctrl+clic su di esso porta alla definizione; nella definizione il marcatore [^1]: resta visibile — è il bersaglio del salto, e devi vederlo per sapere quale nota stai modificando — e Ctrl+clic su di esso torna al riferimento. A differenza di molti visualizzatori Markdown, l'editor non rinumera le note né sposta le definizioni alla fine: l'ordine del file è tuo. Anche la grafia inline di Obsidian e Pandoc — ^[il testo della nota] — viene disegnata: scrivi il testo nel punto in cui chiami la nota e, in modalità lettura, appare numerato in fondo. Il file conserva ciò che hai scritto e, all'esportazione, diventa una vera nota a piè di pagina in Word, LaTeX, Typst ed EPUB.

L'admonition di MkDocs (!!! note con il corpo indentato di 4 spazi) è conservata così com'è scritta nella modifica formattata: l'indentazione è ciò che fa appartenere il corpo all'admonition, quindi il suo testo non riceve formattazione ricca — in cambio, aprire la nota e salvarla non disfa la costruzione.

Anche le scatole con chiusura appaiono come scatola. :::tip … ::: (Docusaurus) e <details> … </details> ricevono barra e titolo colorati, in entrambe le grafie: quella compatta e quella con righe vuote. Il marcatore di apertura lascia il posto all'etichetta del tipo, al titolo che hai scritto o al testo del <summary>; quello di chiusura esce dallo schermo e resta nel file, perché il markup che l'app stessa scrive non deve restare letterale nella pagina. Quel che rimane è l'ultima riga del riquadro: è ciò che lo delimita, è dove si mette il cursore per continuare a scrivere dentro, e non si cancella — senza di essa il contenuto sotto ci finirebbe dentro. Per disfarlo mantenendo il testo, usa Rimuovi il riquadro nel menu contestuale. Il : dell'elenco di definizioni resta attenuato. Il <summary> deve stare sulla stessa riga del <details> per diventare il titolo: su una riga a sé compare così com'è scritto e la scatola mantiene l'etichetta predefinita.

HTML inline e blocco di codice. <kbd>, <mark>, <sub> e <sup> vengono resi anche nella modifica formattata: i tag spariscono e resta solo il contenuto, come nella modalità di lettura. Il blocco di codice recintato riceve una scatola, con il nome del linguaggio e un collegamento copia nell'angolo — lo stesso collegamento nella modifica formattata e nella modalità di lettura, dove si copia più codice. Prende solo il corpo del blocco (senza i marcatori) e dice copiato per un istante; entrambe le etichette compaiono solo quando ci stanno senza scrivere sopra il codice.

Altro nella lettura: il blocco frontmatter YAML iniziale non compare nella nota renderizzata — si modifica nel pannello Proprietà. I tag #hashtag diventano pastiglie cliccabili che aprono la ricerca di quel tag (come Ctrl+clic nell’editor). I commenti in stile Obsidian (%%questo resta nascosto%%, o un blocco tra righe con %%) restano solo nel file. Oltre ai callout di GitHub, vengono resi anche i riquadri dei dialetti Docusaurus (:::tip Titolo … :::) e MkDocs (!!! note "Titolo" con il corpo indentato, e ??? note) — comodo per leggere repository di documentazione.

Novità nella lettura: oltre a ~~barrato~~ e ==evidenziato==, funzionano apice ^x^, pedice ~x~, emoji abbreviate (:rocket:), autolink degli URL, note a piè di pagina [^1], blocchi comprimibili <details>, elenchi di definizioni, attività - [ ]/- [x] (⬜/✅) e il token [TOC] (sommario cliccabile nella lettura); inoltre immagini locali e HTML inline (<kbd>, <mark>…). Il pannello Struttura (barra della scheda) percorre i titoli seguendo il cursore, e il pulsante Inserisci (o il menu contestuale → Formato/Inserisci) applica qualsiasi formattazione.

Titoli, cartella e testo

Intestazioni fisse (sticky scroll): mentre scorri, le intestazioni che contengono la riga in alto restano fissate in una fascia in cima all'editor; farci clic salta a quella sezione (attivabile in Impostazioni → Markdown). Il menu contestuale di una cartella nell'albero crea/apre la Nota della cartella (index.md con frontmatter), utile come indice.

Nota della cartella ed elenco file: fare doppio clic su una cartella apre il suo index.md, se esiste. In qualsiasi nota, il token [files] (o [arquivos]) da solo su una riga viene sostituito nella modifica formattata e nella lettura con l'elenco dei file della cartella della nota, come link cliccabili — generato al volo, senza scrivere nulla nel file (come [TOC]).

Operazioni di testo e di riga. Le operazioni dell'editor di codice valgono anche nella nota — tramite il sottomenu Testo del pulsante Formatta della barra della scheda, il menu contestuale e i sottomenu Righe e Pulizia del menu Modifica: sposta la riga (o le righe selezionate) su/giù (Ctrl+Shift+↑/↓), duplica (Ctrl+Shift+D), elimina (Ctrl+Shift+L), ordina (A→Z / Z→A), inverti l'ordine, unisci righe, rimuovi righe duplicate o vuote, rimuovi spazi e maiuscole/minuscole (e inverti). Numera righe… apre una finestra con inizio, passo, zeri iniziali e separatore — con il valore predefinito (". ") si ottiene un elenco numerato Markdown valido. Con una selezione l'operazione agisce solo su di essa (estesa a righe intere); senza selezione, sull'intero documento — sempre un unico passo di annullamento. La barra della scheda offre anche il pulsante IA: Chiedi / Modifica con l'IA — gli stessi Ctrl+K / Ctrl+I del codice — e Chiedi alle note, la chat che risponde usando le note dello spazio di lavoro.

Suggerire titolo ed etichette. Nello stesso pulsante IA della nota, Suggerisci titolo ed etichette… chiede all'assistente predefinito un titolo ed etichette per la nota aperta. Legge la nota (in una nota lunga, l'inizio e la fine) e l'elenco delle etichette che usi già nello spazio di lavoro, e preferisce riutilizzarle piuttosto che inventare sinonimi. Il suggerimento compare in una piccola finestra modificabile: cambia il titolo, deseleziona o correggi le etichette. Applica scrive title: e tags: nelle proprietà della nota — le etichette si aggiungono a quelle che ha già, senza mai sostituirle — e, se la nota non ha né titolo né intestazione # …, propone di mettere il titolo anche in cima. È una sola modifica: Ctrl+Z la annulla. Senza nessuna IA configurata, la voce propone di collegarne una. Il testo della nota esce dal computer se l'assistente è un servizio cloud; con un modello locale, no.

Intestazioni comprimibili: fai clic sulla freccetta a sinistra di un'intestazione (o usa Ctrl+Shift+[ / Ctrl+Shift+]) per comprimere ed espandere la sezione; in Visualizza ci sono Comprimi/Espandi tutte le intestazioni. La compressione è solo visiva — non viene mai scritta nel file — e LightNote la ricorda tra le sessioni. Saltare dal Sommario o dalla ricerca dentro una sezione compressa la espande.

Raccoglitore: la cartella come opera

Che cos’è: una cartella le cui note sono capitoli, in un ordine che dichiari tu. Va bene per un libro, una tesi, un corso, un manuale, un runbook o un diario di bordo: il meccanismo è lo stesso. Nel menu contestuale della cartella, Trasforma in raccoglitore apre una schermata con le note nell’ordine attuale: trascina per riordinare e conferma. L’ordine viene salvato nella chiave chapters: del index.md della cartella — un file di testo tuo, che viaggia con le note e vale su qualsiasi macchina. Anche una sottocartella può essere nominata nell’ordine: i suoi capitoli entrano nella posizione in cui compare, ed essa dichiara il proprio ordine nel suo index.md — è così che un libro acquista parti. La copertina di una sottocartella non diventa una pagina del documento; serve a dichiarare l’ordine di quel livello e a navigare.

Navigare: con l’ordine dichiarato, la barra della nota mostra Capitolo 3 di 12, con una freccia per lato (Alt+PgUp e Alt+PgDn); il pulsante centrale elenca tutti i capitoli. Il pannello Sommario passa a mostrare due livelli: i capitoli dell’opera e, sotto quello aperto, i suoi titoli. Alle estremità dell’opera la freccia è grigia. In una cartella senza ordine dichiarato non compare nulla di tutto questo, e tutto resta com’era.

Il modello delle note: un raccoglitore può dichiarare da quale modello nascono le note create al suo interno (la chiave template:). Ci sono cinque modelli pronti — capitolo di libro, capitolo di tesi, lezione, passo di procedura e voce di diario — e sceglierne uno lo salva come file nella cartella Templates, dove resta modificabile. Una nota creata dentro il raccoglitore entra da sola nell’ordine; un file lasciato lì da fuori resta sotto Fuori dall’ordine finché non lo adotti. Rinominare un capitolo corregge la chiave e ne conserva la posizione. Per partire da un’opera già pronta, Struttura da un modello… (nel menu contestuale della cartella) scrive le due chiavi in una volta — l’ordine e il modello dei capitoli — conservando la copertina che hai già scritto; e finché c’è un capitolo dichiarato che ancora non esiste, il Sommario mostra un pulsante che li crea tutti insieme, ciascuno già dal modello della cartella. Nulla viene sovrascritto: il capitolo che è già lì resta com’è.

Unire in un solo documento: esportando la cartella, la casella Unire i capitoli in un solo documento produce un file con i capitoli nell’ordine dichiarato. Poiché il testo viene unito prima di essere reso, note a piè di pagina, figure, tabelle e citazioni vengono poi numerate sull’intero documento — e un rimando da un capitolo a una figura di un altro comincia a funzionare. Ciò che non è nell’ordine dichiarato resta fuori, e il rapporto dice cosa.

Proprietà, tema e zoom

Proprietà della nota: il pannello laterale Proprietà mostra il frontmatter YAML come campi tipizzati (testo, numero, data, casella), con la casella Tipo in alto. Impostare il tipo e le proprietà è ciò che permette di raccogliere le note in una Base.

Tema della nota: la casella Tema del pannello Proprietà definisce l'aspetto di questa nota — i colori e il carattere del testo — senza toccare il tema del resto dell'applicazione. La scelta finisce nel frontmatter (la chiave theme), quindi viaggia con il file: la nota si vede uguale su qualsiasi macchina. Il pulsante accanto scrive i colori dentro la nota stessa, così resta uguale anche per chi non ha quel tema. Senza la chiave, la nota segue il tema dello spazio di lavoro. Se preferisci che le note provenienti dall'esterno non cambino il tuo aspetto, disattiva Rispettare il tema dichiarato nella nota in Impostazioni → Markdown.

Un tema che LightNote non conosce ancora: l'elenco dei temi è un unico file scaricato dal sito, quindi una nota che cita un tema pubblicato dopo il tuo ultimo aggiornamento semplicemente non lo trova. La nota si apre allora con il tema dello spazio di lavoro e il pannello Proprietà lo segnala, con una scorciatoia per vedere i temi disponibili. LightNote cerca l'elenco aggiornato da solo — una volta per sessione, in secondo piano e senza bloccare la nota. Se preferisci che non scarichi mai nulla, disattiva Cerca il catalogo strumenti online in Impostazioni → Funzionalità.

Ctrl++ e Ctrl+− (o Ctrl+rotellina) cambiano la dimensione della nota, e Ctrl+0 torna al 100% — comodo per leggere una nota lunga senza toccare il carattere di tutte. L'editor e la lettura vengono ridimensionati insieme: in modalità divisa i due lati restano della stessa dimensione. Anche un <svg> scritto direttamente nella nota viene disegnato nella lettura: puoi incollare un grafico generato dall'IA senza farne un file a parte.

Quante parole, e dove. La barra di stato conta le parole della nota e stima il tempo di lettura; accanto, sezione N è il conteggio della sezione in cui si trova il cursore — la stessa che il Sommario evidenzia, dal suo titolo fino al successivo di livello uguale o superiore. Dichiarando un obiettivo giornaliero in Impostazioni → Note e scrittura, compare anche oggi N/M: ciò che è cresciuto nelle note aperte oggi. Cancellare non sottrae — rivedere il proprio testo non può diventare una punizione —, una nota che non hai aperto non entra, e a mezzanotte il conteggio si azzera.