Markdown Notation
Markdown Notation Manual (Quick Reference & Examples)
Use this guide to format content in your Text Chart. It follows CommonMark basics with popular GitHub-Flavored Markdown (GFM) extensions like tables, task lists, and strikethrough.
Titoli
Usa da # a ###### all’inizio della riga:
# H1
## H2
### H3
#### H4
##### H5
###### H6
Paragrafi & A Capo
Separa i paragrafi con una riga vuota.
A capo singolo (soft break): termina la riga con due spazi o usa <br>.
Prima riga con soft break··
continua sulla riga successiva.
Nuovo paragrafo dopo una 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.
- Elemento A
- Elemento B
- Elemento annidato B1
- Elemento annidato B2
1. Passo uno
2. Passo due
1. Sotto-passo
2. Sotto-passo
Consiglio: Usa sempre 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: [Docs][docs-link]
[docs-link]: https://example.com/docs
Immagini
Il testo alternativo (alt text) è importante per l’accessibilità.
Immagini con riferimento:
![Logo][logo]
[logo]: https://example.com/logo.png
Blockquotes
Utilizza > all’inizio della riga. Annida usando più >.
> Citazione su una riga singola.
>
> Citazione su più paragrafi:
>
> > Citazione annidata livello 2.
Codice (Inline & Fenced)
Il codice inline usa tre backtick ```code. [il tuo codice] ```
I blocchi di codice (fenced blocks) si creano con tre backtick. Aggiungi una lingua per l’highlighting della sintassi.
- Esempi ```code
Ecco del `codice inline`.
Se il tuo contenuto include già tre backtick, racchiudi il codice con quattro backtick.
Separatori Orizzontali
Tre o più di ---, *** o ___ su una riga da soli:
---
Tabelle
Usa pipe | e separatori di header ---. I due punti (:) gestiscono 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 visualizzarla correttamente.
Liste di Task
Usa - [ ] e - [x].
- [x] Disegna lo schema
- [ ] Implementa API
- [ ] Scrivi test
- Disegna lo schema
- Implementa API
- Scrivi test
Escape Caratteri Speciali
Usa una backslash \ per visualizzare i caratteri letteralmente.
\*Non corsivo\*, mostra letteralmente gli asterischi.
Usa la backslash per \#, \[, \], \(, \), \_, \*, \`, \|, \>
Link & Immagini con Riferimento
Rendi il contenuto più pulito raggruppando 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 inserite vengono spesso autolinkate. Le parentesi angolari lo rendono obbligatorio.
https://example.com
<mailto:hello@example.com>
HTML Inline (Opzionale)
La maggior parte dei renderizzatori permette HTML inline sicuro quando Markdown non basta.
<strong>Grassetto</strong> e <em>corsivo</em> con HTML.
<br>
<span style="font-variant:small-caps">Maiuscoletto</span>
Nota: Non tutti i tag sono supportati, per motivi di sicurezza e compatibilità.
Errori Comuni
- A capo: usa due spazi finali o
<br>. - Annidamento liste: rientra bene gli elementi annidati (2–4 spazi).
- Code block: aggiungi la lingua dopo i backtick d’apertura per l’evidenziazione.
- Tabelle: inserisci una riga vuota prima della tabella.
- Immagini: fornire sempre un alt text descrittivo.
- Tab/spazi: preferisci gli spazi per risultati uniformi.
Template di Partenza
Copia e personalizza:
### 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