Note e Markdown

Ultimo aggiornamento: 2026-07-22

Ogni nota in Plainva è un normale file Markdown (.md). Questa pagina spiega come scrivere comodamente e cosa finisce effettivamente nel file — perché è proprio questo che rende le tue note portabili: qualsiasi editor di testo, Obsidian o un diff di git può leggerle.

Il principio fondamentale: tutto è testo

Qualunque cosa tu veda in Plainva — testo formattato, tabelle, proprietà, icone — è memorizzata come testo aperto:

---
type: Note
okf_version: "0.1"
tags: [project]
plainva:
  icon: "🚀"
  header_color: "#2f6f6f"
---
# Il mio progetto

Un pensiero **in grassetto** con un link a [[Un'altra nota]].

- [ ] Prima attività

Il blocco tra le righe --- è il frontmatter (YAML): è lì che vivono le proprietà della nota. Sotto viene il normale testo Markdown. La presentazione specifica di Plainva (icona, colore dell’intestazione) è raggruppata sotto l’unica chiave plainva: — gli altri programmi la ignorano semplicemente.

Scrivere in Anteprima dal vivo

Anteprima dal vivo è la modalità predefinita: il Markdown viene renderizzato mentre digiti restando comunque sempre modificabile.

Il menu slash

Digita / all’inizio di una riga per aprire il menu di inserimento. È suddiviso in sezioni:

• Blocchi di base — Testo, Titolo 1–6, Elenco puntato, Elenco numerato, Elenco di cose da fare, Citazione, Blocco di codice, Tabella, Separatore, Formula (LaTeX), Diagramma Mermaid
• Formattazione — Grassetto, Corsivo, Barrato, Codice in linea, Evidenziazione, Emoji
• Link e media — Link, Link interno, Immagine (web), Immagine interna, Incorpora, Incorpora database, Crea database in linea
• Documento — Icona del documento, Colore dell’intestazione, Inserisci modello
• Callout — 13 varianti (Nota, Info, Da fare, Riepilogo, Suggerimento, Successo, Domanda, Avviso, Fallimento, Pericolo, Bug, Esempio, Citazione)

Altri aiuti per la scrittura

• Barra degli strumenti di selezione — seleziona del testo e una piccola barra offre Grassetto, Corsivo, Barrato, Codice in linea, Evidenziazione e Link.
• Menzioni @ — digita @ ovunque nel testo per inserire una Data (Oggi, Domani, Ieri o Scegli una data…, memorizzata come data ISO), un link a una Nota, o un incorporamento di Database.
• Emoji — il comando slash Emoji (/emoji) apre un selettore di emoji alla posizione del cursore; oppure digita :name (ad esempio :rocket) per ottenere suggerimenti in linea. In entrambi i casi Plainva inserisce il carattere emoji vero e proprio (Unicode portabile), mai uno :shortcode: — così la nota resta leggibile in Obsidian, su GitHub e ovunque altro. (Questa funzione è indipendente dall’Icona del documento della nota, memorizzata nel frontmatter.)
• Maniglie dei blocchi — al passaggio del mouse compare una maniglia a sinistra di ogni paragrafo: trascinala per spostare il blocco, clicca per aprire Azioni sul blocco (Trasforma in Testo/Titolo/Elenco/Da fare/Citazione/Blocco di codice, Duplica, Sposta su/Sposta giù, Elimina blocco). Se trascini un elenco accanto a un altro elenco dello stesso tipo, Plainva inserisce una riga separatrice invisibile <!-- --> in modo che i due elenchi restino separati — in Markdown, elenchi dello stesso stile si fonderebbero altrimenti nonostante la riga vuota (anche in Obsidian).
• Tabelle — renderizzate come widget con celle modificabili con un clic. La visualizzazione della cella rende la formattazione (grassetto, corsivo, codice, evidenziazione), i link cliccabili ([[Link interno]], indirizzi web) e <br> come interruzione di riga; durante la modifica vedi il testo grezzo. Il menu della tabella offre l’inserimento/eliminazione di righe e colonne oltre all’allineamento (Allinea a sinistra/Allinea al centro/Allinea a destra).
• Gli elenchi continuano da soli (Invio inserisce il prossimo marcatore di elenco), i blocchi di codice ottengono un’evidenziazione sensibile al linguaggio (anche in modalità lettura), il contenuto incollato viene convertito in Markdown (incolla intelligente) e i titoli possono essere ripiegati.
• Trova e sostituisci all’interno della nota corrente: Ctrl+F (vedi Ricerca).

Link e backlink

• Link interni: [[Nome nota]] (wiki-link) — tramite il menu slash o @ con ricerca integrata delle note. Funzionano anche i classici link Markdown [testo](percorso.md).
• Destinazioni non ancora create: un wiki-link a una nota che non esiste ancora viene mostrato attenuato e con una sottolineatura tratteggiata (sia in anteprima dal vivo sia in modalità lettura). Un clic crea la nota e la apre — viene collocata nella cartella della nota corrente (oppure nel percorso indicato, se il link ne contiene uno, ad es. [[Cartella/Nuova nota]]). Per essere avvisato prima, abilita Impostazioni → App → Editor e note → Chiedi prima di creare link vuoti.
• Backlink: la sezione Backlink nella barra laterale destra mostra quali note collegano quella attiva — raggruppate per file sorgente, con un contatore per le occorrenze multiple.
• Rinomina con cura dei link: quando rinomini un file nell’albero dei file, Plainva aggiorna ogni link ad esso in tutto il vault (le ancore come #Sezione vengono preservate) e riporta: “N link in M file sono stati aggiornati al nuovo nome.”

Proprietà (frontmatter)

La sezione Proprietà nella barra laterale destra mostra il frontmatter della nota come un modulo. Aggiungi proprietà ne crea di nuove; ogni proprietà ha un Tipo di campo:

I tipi a scelta possono avere opzioni fisse con un Colore e (per Stato) un Gruppo/fase — questi elenchi di opzioni sono gestiti nei database (.base), vedi Database (.base).

Due campi sono protetti: type e okf_version sono campi di sistema OKF gestiti da Plainva — il valore di type è selezionabile da un menu a tendina di tipi noti, mentre nome/tipo di campo/eliminazione sono bloccati (approfondimento: OKF).

Icona del documento e colore dell’intestazione

Ogni nota può avere un’icona (in stile Notion sopra il titolo, visibile anche nelle schede e nell’albero dei file) e una striscia di colore a larghezza piena:

• In Anteprima dal vivo, passa il mouse sopra il titolo: Aggiungi icona / Aggiungi colore intestazione (in seguito: Cambia icona / Cambia colore intestazione) — oppure usa i comandi slash Icona del documento e Colore dell’intestazione.
• Il selettore di icone ha due modalità: Emoji e Icone (il set di icone Lucide, con un colore selezionabile).
• Entrambe sono memorizzate nel frontmatter sotto plainva: (icon, icon_color, header_color) — pura presentazione che non influisce sugli altri programmi.

Modelli

Imposta una Cartella dei modelli in Impostazioni → Vault → Contenuto e struttura (Scegli cartella… accanto al campo permette di scegliere la cartella direttamente nel vault). Poi inserisci i modelli con Ctrl+Alt+T o il comando slash Inserisci modello. I modelli definiscono completamente il contenuto dei nuovi file — incluso il frontmatter: se un modello porta un proprio type, vince il modello. Quando inserisci in una nota esistente, il frontmatter del modello viene omesso — viene inserito solo il contenuto.

Segnaposto: i modelli interpolano {{title}} (il titolo della nota), {{date}} e {{time}}. Quando inserisci un modello, se ne risolvono altri due: {{cursor}} indica dove atterrerà il cursore in seguito, e {{prompt:Label}} ti chiede un valore (mostrato come Label) e inserisce la tua risposta. Creare una nuova nota da un modello rimuove {{cursor}} e lascia vuoto ogni {{prompt:…}}.

Creare modelli funziona da qualsiasi punto: la palette dei comandi (Ctrl+P) offre Crea nuovo modello (si apre un modello nuovo pronto per la modifica) e Salva la nota corrente come modello (copia la nota aperta nella cartella dei modelli). I modelli sono normali file Markdown — modificali, rinominali o eliminali direttamente nell’albero dei file.

Note giornaliere

Apri nota giornaliera (barra laterale) o un clic nel Calendario crea la nota di oggi usando il tuo formato data nella cartella delle note giornaliere configurata, facoltativamente da un modello.

Attività, formule, diagrammi e note a piè di pagina

• Caselle di attività: - [ ] attività viene renderizzata ovunque come casella di controllo — e in modalità lettura puoi cliccarla: Plainva riscrive [x] o [ ] nel file.

• Formule matematiche (LaTeX): $E = mc^2$ in linea e $$…$$ come blocco vengono renderizzati come formule sia in modalità lettura sia nell’anteprima dal vivo (KaTeX). Con il cursore all’interno di una formula vedi la sintassi; un clic su una formula renderizzata la apre per la modifica. Solo la modalità sorgente mostra sempre la sintassi grezza. Non devi imparare a memoria il blocco $$…$$ — il comando slash Formula (LaTeX) (/katex) lo inserisce e posiziona il cursore al suo interno.

• Diagrammi Mermaid: un blocco di codice con il linguaggio mermaid (nel modo più rapido tramite il comando slash Diagramma Mermaid, /mermaid) viene disegnato come diagramma in modalità lettura e nell’anteprima dal vivo — un clic sul diagramma mostra il codice per la modifica:

  ```mermaid
  graph TD
    Idea --> Note --> Knowledge
  ```

• Note a piè di pagina: Testo[^1] più [^1]: La nota a piè di pagina. alla fine — la modalità lettura renderizza il riferimento e l’apparato delle note a piè di pagina con segni di salto. Il modo più rapido è il comando slash Nota a piè di pagina (/footnote): inserisce il prossimo riferimento libero e salta direttamente alla definizione in fondo alla nota.

Stampa e salvataggio come PDF

Il menu ⋮ dell’editor e la palette dei comandi (Ctrl+P) hanno Stampa / Salva come PDF…: la stampa usa sempre la vista di lettura (da dal vivo/sorgente, Plainva passa prima a quella). Nella finestra di dialogo di sistema puoi scegliere “Salva come PDF” invece di una stampante.

Esportare una nota

• Esporta come Markdown… (menu ⋮ dell’editor o palette dei comandi): salva una copia della nota in qualsiasi posizione tramite la finestra di dialogo di sistema — ad esempio per consegnarla a un altro programma. Gli allegati collegati (immagini) non vengono copiati insieme; se la nota ne referenzia, Plainva mostra un breve avviso.
• PDF: usa Stampa / Salva come PDF… (sopra) e scegli “Salva come PDF” nella finestra di dialogo di sistema.

Aprire una nota in un altro editor

Le tue note sono normali file .md, quindi qualsiasi editor Markdown può aprirle. Il menu ⋮ dell’editor include Apri nell’app predefinita, che passa la nota corrente all’app che il tuo sistema usa per i file Markdown (Byword, MacDown, VS Code e così via). Plainva continua a osservare il file, quindi le modifiche che fai lì compaiono automaticamente qui.

Immagini e allegati

• Inserimento: comandi slash Immagine interna (cerca e incorpora dal vault) o Immagine (web) (tramite URL). Inoltre: puoi semplicemente incollare un’immagine dagli appunti (Ctrl+V) — viene salvata accanto alla nota e incorporata. E puoi trascinare i file dall’esplora risorse nell’editor: le immagini vengono incorporate (![[…]]), gli altri file vengono copiati e collegati ([[…]]).
• Visualizzazione: i file immagine (PNG, JPG, GIF, WebP, SVG, BMP, AVIF) si aprono nel visualizzatore di immagini integrato con Aumenta zoom/Riduci zoom, Adatta e Dimensione reale (1:1).
• Modifica: il pulsante Modifica apre l’editor di immagini con Ritaglia, ruota/capovolgi, Ridimensiona, strumenti di disegno (Penna, Freccia, Rettangolo, Testo) più Annulla/Ripeti. Salva sul posto o Salva come copia…. I formati modificabili sono PNG, JPG e WebP; gli altri formati si aprono in sola visualizzazione.
• Gli altri allegati si aprono con un doppio clic nel programma predefinito del sistema.

E Obsidian?

Tutto resta Markdown standard con frontmatter standard. Obsidian apre i file completamente; mostra la chiave plainva: raggruppata come un oggetto non modificabile nel suo pannello delle proprietà — questo è voluto e innocuo.

Vedi anche

• Database (.base) — le note come tabella, bacheca o calendario
• OKF — cosa significano type e okf_version
• Ricerca e Scorciatoie da tastiera

Formattare una selezione

Quando una selezione include più righe, grassetto, corsivo, barrato, evidenziazione e codice in linea vengono applicati separatamente a ogni riga non vuota. I prefissi di elenco, citazione, titolo e attività restano fuori dai marcatori. I link restano su una riga perché un’etichetta multiriga non è Markdown portabile.

Un titolo ATX e un’attività GFM sono tipi di blocco alternativi. Plainva non scrive combinazioni non valide. La formattazione in linea funziona in entrambi; usa - [ ] **Attività importante** per evidenziare il titolo.