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.

Codice inline

Usa git status per vedere lo stato del repository.

Blocchi di codice (fenced_code + codehilite)

Con linguaggio dichiarato — viene evidenziato:

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

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]

attr_list — attributi HTML su elementi

#mia-ancora" id="un-titolo-con-un-ancora-personalizzata">Un titolo con un ancora personalizzata

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

• 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)

HTML grezzo (passa invariato, nessuna sanificazione)

Questo testo è evidenziato con un tag HTML scritto a mano.

Anche gli stili inline funzionano, se proprio servono.

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)