# Titolo del post

[//]: # (title: Esempi di sintassi supportata)
[//]: # (description: Un file di riferimento con esempi per ogni sintassi markdown accettata da madblog.)
[//]: # (author: Il tuo nome)
[//]: # (published: 2026-08-22)
[//]: # (tags: riferimento,markdown)


Questo file è pensato per essere caricato com'è in `markdown/` e visto renderizzato:
ogni sezione mostra un paio di esempi della sintassi corrispondente.

## Titoli

# Questo è un h1
## Questo è un h2
### Questo è un h3
#### Questo è un h4

## Grassetto e corsivo

Questo è **testo in grassetto**, questo è *testo in corsivo*, e questo è ***entrambi***.

## Citazione

> Questa è una citazione su una riga.
>
> E questa è una citazione su più righe,
> con un secondo paragrafo dentro.

## Liste puntate e numerate

- Primo elemento
- Secondo elemento
  - Sotto-elemento annidato
   - Sotto-elemento annidato
     - Sotto-elemento annidato
- Terzo elemento

1. Primo passo
2. Secondo passo
3. Terzo passo

## Linea orizzontale

Testo sopra la linea.

---

Testo sotto la linea.

## Link e immagini

Un [link a datoperscontato.it](https://www.datoperscontato.it).

![Testo alternativo di un'immagine](/img/icon-512.png)

## Codice inline

Usa `git status` per vedere lo stato del repository.

## Blocchi di codice (fenced_code + codehilite)

Con linguaggio dichiarato — viene evidenziato:

```python
def saluta(nome: str) -> str:
    return f"Ciao, {nome}!"
```

Senza linguaggio dichiarato — **nota verificata**: `guess_lang=False`, quindi
resta semplice testo, nessun tentativo di indovinare il linguaggio:

```
questo blocco non avrà colori di sintassi
anche se sembra codice
```

## Tabelle

| Nome       | Ruolo       | Attivo |
|------------|-------------|--------|
| Autore     | Scrittore   | sì     |
| Lettore    | Commentatore| no     |

## Indice (TOC)

Il marcatore va messo dove vuoi che compaia l'indice. Tutte queste varianti
sono equivalenti (normalizzate dall'estensione custom di madblog):

[[TOC]]
```
[TOC]
[[TOC]]
{{ TOC }}
<!-- TOC -->
```

## attr_list — attributi HTML su elementi

## Un titolo con un ancora personalizzata {: #mia-ancora }

Un paragrafo con una classe. {: .evidenziato }

## sane_lists — liste che non si confondono cambiando marcatore

- Lista con trattini
- Resta separata da...

* ...questa lista con asterischi,
* anche se sono adiacenti nel file sorgente.

## URL nude auto-linkate

Se scrivi https://www.datoperscontato.it senza parentesi, diventa comunque
un link cliccabile.

## Task list

- [x] Scrivere questo file di esempi
- [ ] Pubblicarlo sul blog
- [ ] Controllare che tutto renderizzi bene

## Hashtag

Questo articolo parla di #markdown e di #documentazione.

## Menzioni ActivityPub

Puoi menzionare @utente@mastodon.social e verrà linkato al suo profilo.

## LaTeX (attivo di default: `enable_latex: true`)

Formula in blocco con doppio dollaro:

$$E = mc^2$$

Formula in blocco con `\[...\]`:

\[ \int_0^1 x^2 \,dx = \frac{1}{3} \]

Formula inline con `\(...\)` — **nota verificata**: il singolo `$...$` per
inline è disabilitato nel codice di madblog, va usato `\(...\)`:

Il rapporto \(a/b\) è definito solo se \(b \neq 0\).

## Mermaid (attivo di default: `enable_mermaid: true`, richiede Node.js + mermaid-cli sul server)

```mermaid
graph TD
  A[Scrivi il post] --> B{Ha bisogno di fili/domande?}
  B -->|Sì| C[Crea il file .yaml in metadata/]
  B -->|No| D[Pubblica così com'è]
```

## HTML grezzo (passa invariato, nessuna sanificazione)

<mark>Questo testo è evidenziato</mark> con un tag HTML scritto a mano.

<p style="color: var(--red);">Anche gli stili inline funzionano, se proprio servono.</p>

## Metadati (righe `[//]: # (chiave: valore)` in cima al file)

Per mostrarle qui senza che vengano interpretate (altrimenti sarebbero invisibili,
è il loro scopo), le racchiudo in un blocco di codice:

```
[//]: # (title: Titolo del post)
[//]: # (description: Descrizione breve)
[//]: # (image: /img/nome-file.jpg)
[//]: # (author: Nome Autore)
[//]: # (published: 2026-08-22)
[//]: # (tags: tag1,tag2,tag3)
```