Matematica e diagrammi

KaTeX compone le formule, Mermaid renderizza i diagrammi, i blocchi di codice ricevono l’evidenziazione della sintassi — nella vista Lettura, nella vista divisa e nella modalità Live.

KaTeX in linea

Le formule tra segni di dollaro singoli si renderizzano nel testo corrente. Un’euristica protegge gli importi in dollari: $100 in una frase resta testo, solo le vere coppie di formule vengono composte.

La soluzione è $x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$ secondo la formula quadratica.

La soluzione è $x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$ secondo la formula quadratica.

KaTeX come blocco

I doppi segni di dollaro compongono una formula isolata e centrata.

$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$

$$\sum_{i=1}^{n} i = \frac{n(n+1)}{2}$$

Mermaid

I blocchi di codice con il tag di lingua mermaid si renderizzano come diagrammi SVG e seguono il tema. I tipi comuni:

Flowchart

```mermaid
flowchart LR
  A[Inizio] --> B{Decisione}
  B -->|sì| C[Implementare]
  B -->|no| D[Scartare]
```

flowchart LR
  A[Inizio] --> B{Decisione}
  B -->|sì| C[Implementare]
  B -->|no| D[Scartare]

Sequence

sequenceDiagram
  participant U as Utente
  participant A as App
  U->>A: apri file
  A-->>U: vista renderizzata

Gantt

gantt
  dateFormat YYYY-MM-DD
  title Mini piano
  section Fase 1
  Concetto        :a1, 2026-01-01, 10d
  Implementazione :after a1, 15d

Class

classDiagram
  class Tab {
    +path
    +viewMode
    +close()
  }
  class Pane
  Pane "1" --> "*" Tab

Blocchi di codice con evidenziazione della sintassi

Un tag di lingua dopo gli accenti gravi di apertura attiva la palette di colori (segue il tema):

```javascript
function greet(name) {
  return `Ciao, ${name}!`;
}
```

function greet(name) {
  return `Ciao, ${name}!`;
}

Il pulsante di copia in alto a destra del blocco copia il contenuto negli appunti — anche qui nel manuale.

Esportazione

• Esportazione PDF: i diagrammi vengono stampati come grafica vettoriale renderizzata, ridisegnata in chiaro per la stampa; formule ed evidenziazione del codice appaiono come nell’anteprima.
• Markdown portabile: l’esportazione imprime il diagramma nel file come immagine finita: il destinatario lo vede senza possedere questo programma. Viene sempre disegnato in chiaro, indipendentemente dallo schema di colori in cui lavorate. Un diagramma con testo sorgente errato resta invariato come blocco di codice, cosi da non perdere la sorgente; lo stesso vale con l’estensione «Diagrammi Mermaid» disattivata. Il diagramma figura nel file come immagine con indirizzo incorporato; richiede un visualizzatore Markdown che mostri l’HTML incorporato e immagini di questo tipo: per l’HTML, lo stesso requisito delle tabelle Perspective esportate. Le formule KaTeX e i blocchi di codice con tag di linguaggio sono sintassi Markdown ordinaria e non ne sono interessati.