Code, formules et diagrammes

Les notes ne sont pas seulement de la prose. Gardez une commande que vous oubliez toujours, écrivez une formule correctement ou esquissez un processus sous forme de diagramme, le tout dans la même note, le tout dessiné sur votre Mac sans connexion Internet.

Code en ligne

Entourez une commande courte, un nom de fichier ou un réglage d’accents graves, ou sélectionnez le texte et utilisez ⌥⌘C :

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

Blocs de code

Pour plusieurs lignes, utilisez un bloc de code. Appuyez sur ⌃⌘C, ou saisissez trois accents graves sur une ligne à part : Varlig ajoute les marqueurs de fermeture et propose un langage. Choisir un langage, par exemple python ou swift, active la coloration syntaxique du code.

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

Le bouton Copy Code, à côté du bloc, copie son contenu sans les accents graves. Les lignes qui délimitent le bloc restent masquées tant que le curseur n’est pas dans celui-ci.

Deux identifiants ont un rôle particulier : calc transforme le bloc en calculatrice — voir Votre premier calcul — et mermaid dessine un diagramme, comme ci-dessous.

Lignes longues

Par défaut, les longues lignes de code passent visuellement à la ligne. Settings › Editor › Scroll long code lines instead of wrapping les conserve sur une seule ligne avec défilement horizontal. Un … indique que la ligne continue ; déplacer le curseur affiche la suite, et un balayage horizontal fait défiler le bloc. Le texte de la note ne change jamais : aucun caractère n’est inséré, et copier ou exporter le bloc restitue exactement votre saisie.

Formules

Écrivez les formules mathématiques en notation TeX. Entourez une formule d’un signe dollar de chaque côté pour l’insérer dans une phrase avec Format › Math Formula. Pour l’afficher en bloc avec Format › Math Block, placez-la entre deux lignes contenant chacune deux signes dollar :

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

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

Lorsque le curseur est dans une formule, son code source et un aperçu en direct apparaissent pendant la saisie. Varlig reconnaît les commandes TeX courantes ; une commande inconnue affiche une erreur à la place de la formule.

Une formule affiche la notation mathématique. Pour obtenir un résultat numérique, utilisez un bloc de calcul.

Diagrammes Mermaid

Décrivez un organigramme, une chronologie ou un autre diagramme en texte : Varlig le dessine dans la note. Choisissez Format › Mermaid Diagram pour insérer un exemple de départ, ou écrivez un bloc mermaid :

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

La première ligne indique le type de diagramme. Varlig prend notamment en charge les organigrammes (flowchart ou graph), sequenceDiagram, classDiagram, stateDiagram, erDiagram, pie, gantt, journey, timeline, mindmap, gitGraph, quadrantChart, xychart, sankey et kanban. Modifiez le texte : le diagramme s’actualise.

Un diagramme peut avoir jusqu'à 512 lignes, 256 boîtes et 512 connexions.

En-tête YAML

Certains outils lisent les métadonnées en haut d'un fichier Markdown. Choisissez Format › YAML Front Matter pour ajouter un bloc entre deux lignes --- au tout début de la note :

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

Varlig conserve exactement les métadonnées initiales (front matter) telles que vous les écrivez et utilise la première ligne qui les suit comme titre de la note.

HTML

Varlig affiche les balises HTML en tant que texte plutôt que de les transformer en formatage. La seule exception est <br>, qui commence une nouvelle ligne.