Markdown Notation
Manuale Markdown Notation (Guida rapida ed esempi)
Usa questa guida per formattare i contenuti nei tuoi Text Chart. ProcessMind supporta le principali regole CommonMark e le estensioni più diffuse di GitHub-Flavored Markdown (GFM), come tabelle, checklist e barrato.
Titoli
Usa da # a ###### all’inizio di una riga:
# H1
## H2
### H3
#### H4
##### H5
###### H6
Paragrafi & Andare a capo
Separa i paragrafi con una riga vuota.
A capo singolo (soft break): termina la riga con due spazi oppure usa <br>.
Prima riga con soft break··
continua sulla riga successiva.
Nuovo paragrafo dopo la riga vuota.
Enfasi (Corsivo, Grassetto, Barrato)
*corsivo* o _corsivo_
**grassetto** o __grassetto__
***grassetto corsivo***
~~barrato~~ <!-- GFM -->
Liste (Puntate, Numerate, Annidate)
Puntate: -, + o *. Numerate: 1., 2. ecc.
- Voce A
- Voce B
- Voce B1 annidata
- Voce B2 annidata
1. Step uno
2. Step due
1. Sotto-step
2. Sotto-step
Consiglio: Usa lo stesso rientro (2–4 spazi) per le annidate.
Link
Inline e con riferimento:
Inline: [ProcessMind](https://processmind.com)
Con titolo: [Sito](https://example.com "Titolo opzionale")
Riferimento: [Documentazione][docs-link]
[docs-link]: https://example.com/docs
Immagini
L’alt text è fondamentale per l’accessibilità.
Immagini con riferimento:
![Logo][logo]
[logo]: https://example.com/logo.png
Blockquote
Usa > all’inizio di una riga. Annida con più >.
> Una citazione su una riga.
>
> Citazione su più paragrafi:
>
> > Citazione annidata livello 2.
Codice (Inline & Fenced)
Il codice inline usa le triple accentate: ```codice. [tuo codice] ```
I blocchi di codice usano triple accentate. Aggiungi una lingua per evidenziare la sintassi.
- Esempi ```codice
Ecco `inline code`.
Se il contenuto contiene triple accentate, usa quattro accentate.
Separatori Orizzontali
Tre o più di ---, *** o ___ da soli sulla riga:
---
Tabelle
Usa pipe | e linee di separazione ---. I due punti (:) servono per l’allineamento.
| Colonna | Tipo | Note |
|:-------------|:-------:| :----------------- |
| Nome | String | Allineato a sinistra |
| Score | Number | Allineato a sinistra |
| Descrizione | String | Allineato a sinistra |
| Colonna | Tipo | Note |
|---|---|---|
| Nome | String | Allineato a sinistra |
| Score | Number | Allineato a sinistra |
| Descrizione | String | Allineato a sinistra |
Una riga vuota prima della tabella aiuta alcuni parser a visualizzare correttamente.
Liste di Task
Usa - [ ] e - [x].
- [x] Disegna schema
- [ ] Implementa API
- [ ] Scrivi test
- Disegna schema
- Implementa API
- Scrivi test
Caratteri Speciali
Metti una barra inversa \ prima del carattere per visualizzarlo letteralmente.
\*Non corsivo\*, per mostrare gli asterischi.
Usa la barra inversa con \#, \[, \], \(, \), \_, \*, \`, \|, \>
Link & Immagini con Riferimento
Mantieni il contenuto ordinato mettendo i riferimenti in fondo.
Leggi la [Guida][g].
Guarda il ![Badge][b].
[g]: https://example.com/guide
[b]: https://example.com/badge.svg
Autolink & Email
Le URL scritte direttamente diventano link automatici. Le parentesi angolate li forzano.
https://example.com
<mailto:hello@example.com>
HTML Inline (Opzionale)
La maggior parte dei renderer permette l’HTML inline quando Markdown non basta.
<strong>Grassetto</strong> e <em>corsivo</em> con HTML.
<br>
<span style="font-variant:small-caps">Small caps</span>
Nota: Non tutti i tag HTML sono supportati per ragioni di sicurezza e compatibilità.
Errori Comuni
- Andare a capo: Usa due spazi finali o
<br>. - Liste annidate: Indenta gli elementi annidati in modo coerente (2–4 spazi).
- Blocchi di codice: Specifica una lingua dopo le accentate per l’highlight.
- Tabelle: Metti una riga vuota prima della tabella.
- Immagini: Usa sempre alt text descrittivi.
- Misto tab/spazi: Preferisci gli spazi per risultati prevedibili.
Template di partenza
Copia e adatta:
### Title of TextChart
Short intro paragraph that explains the context.
Value of the metric ${metric} is measured.
Visit us at: https://processmind.com
#### Punti Chiave
- Punto A
- Punto B
- Punto C