Codice, formule e diagrammi

Le note possono contenere più del semplice testo: conserva un comando che dimentichi spesso, scrivi una formula ben impaginata o rappresenta un processo con un diagramma. Tutto resta nella stessa nota e viene visualizzato sul Mac senza richiedere una connessione Internet.

Codice in linea

Racchiudi un comando breve, un nome di file o un'impostazione tra accenti gravi (backtick), oppure selezionalo e premi ⌥⌘C:

Restart the router, then run `ping 1.1.1.1` to check.

Blocchi di codice

Per più righe, usa un blocco di codice. Premi ⌃⌘C oppure scrivi tre accenti gravi su una riga a sé: Varlig aggiunge i delimitatori di chiusura e propone un linguaggio. Scegliendone uno, ad esempio python o swift, attivi l'evidenziazione della sintassi.

```python
for item in packing_list:
    print(item)
```

Il pulsante Copy Code accanto al blocco ne copia il contenuto senza i delimitatori. Le righe con gli accenti gravi restano nascoste finché il cursore non si trova nel blocco.

Due identificatori hanno un comportamento speciale: calc trasforma il blocco in una calcolatrice (vedi Il tuo primo calcolo), mentre mermaid genera un diagramma, come descritto sotto.

Righe lunghe

Per impostazione predefinita, le righe di codice vanno a capo. Settings › Editor › Scroll long code lines instead of wrapping mantiene invece ogni riga su un'unica linea con scorrimento orizzontale. Il simbolo … indica che il testo continua; spostando il cursore lungo la riga o scorrendo lateralmente sul blocco, puoi vedere il resto. Il testo della nota non cambia: non viene inserito nulla e, copiando o esportando il blocco, ottieni esattamente ciò che hai scritto.

Formule

Scrivi le formule matematiche in notazione TeX. Racchiudile tra singoli simboli del dollaro per inserirle in una frase (Format › Math Formula), oppure tra doppi simboli del dollaro su righe separate per visualizzarle come blocco (Format › Math Block):

The area of a circle is $\pi r^2$.

$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$

Quando il cursore è in una formula, vedi il sorgente con un'anteprima che si aggiorna mentre scrivi. Varlig supporta i comandi TeX più comuni; un comando non riconosciuto mostra un errore al posto della formula.

Le formule servono a visualizzare la notazione matematica. Per ottenere un risultato numerico, usa un blocco di calcolo.

Diagrammi Mermaid

Descrivi in testo un diagramma di flusso, una sequenza temporale o un altro diagramma: Varlig lo disegna nella nota. Scegli Format › Mermaid Diagram per inserire un esempio iniziale oppure scrivi un blocco mermaid:

```mermaid
flowchart LR
  Idea --> Plan --> Done
```

La prima riga indica il tipo di diagramma. Varlig supporta i diagrammi di flusso (flowchart o graph), sequenceDiagram, classDiagram, stateDiagram, erDiagram, pie, gantt, journey, timeline, mindmap, gitGraph, quadrantChart, xychart, sankey, kanban e altri. Modificando il testo, il diagramma si aggiorna.

Un diagramma può contenere fino a 512 righe, 256 riquadri e 512 collegamenti.

Metadati iniziali YAML (front matter)

Alcuni strumenti leggono i metadati all'inizio di un file Markdown. Scegli Format › YAML Front Matter per aggiungere un blocco tra due righe --- all'inizio della nota:

---
project: Kitchen
status: planning
---

Varlig conserva l'intestazione di metadati esattamente come la scrivi e usa la prima riga successiva come titolo della nota.

HTML

Varlig mostra i tag HTML come testo piuttosto che trasformarli in formattazione. L'unica eccezione è <br>, che inizia una nuova riga.