Skip to main content

Come usare Markdown (CommonMark) nella nostra wiki

Nota: Questo documento è una traduzione automatica della versione originale in inglese.

Questa pagina è un breve "cheat sheet" per la formattazione delle pagine nella nostra wiki, dove i contenuti sono scritti in CommonMark Markdown.

Regole di base

  • Scrivi usando frasi semplici e brevi.
  • Rendi la pagina facile da scansionare (leggere velocemente): intestazioni + elenchi + tabelle.
  • Una sezione = un'idea. Evita i "muri di testo".

Intestazioni

Usa ## / ### / #### per la struttura.

## Sezione
### Sottosezione
#### Sotto-sottosezione

Grassetto, corsivo, codice in linea

**grassetto**
*corsivo*
`codice/campo/indirizzo`

[testo del link](https://example.com)

Se hai bisogno di mostrare un link "grezzo" (raro):

`https://example.com`

Elenchi

Elenco puntato:

- elemento 1
- elemento 2
  - sotto-elemento

Elenco numerato:

1. passaggio 1
2. passaggio 2
3. passaggio 3

Citazioni / note

> Questa è una nota importante.
> Può essere di due righe.

Tabelle

Modello minimo:

| Campo | Valore |
|---|---|
| Nome | [ ] |
| Stato | [ ] |

Suggerimenti:

  • La riga di separazione |---|---| è obbligatoria.
  • Le celle della tabella possono contenere **grassetto**, link e codice.

Blocchi di codice e testo "grezzo"

Blocco di codice:

\```text
riga 1
riga 2
\```

Se si tratta di un linguaggio specifico (ad esempio, JSON), puoi specificarlo:

\```json
{ "chiave": "valore" }
\```

Immagini

Se hai un URL diretto dell'immagine:

![descrizione](https://example.com/immagine.png)

Se il file viene caricato sulla wiki, usa il link/codice di incorporamento fornito dalla wiki al momento del caricamento.

Interruzioni di riga e paragrafi

  • Un nuovo paragrafo è una riga vuota tra i paragrafi.
  • Se hai bisogno di un'interruzione di riga all'interno di un paragrafo, aggiungi due spazi alla fine della riga:
Prima riga.  
Seconda riga.

HTML incorporato (usare con cautela)

Blocco "Dettagli" espandibile

Usalo per dettagli/prove lunghi per evitare di sovraccaricare la "prima schermata".

<details>
<summary><b>Dettagli</b></summary>

Puoi inserire testo, elenchi e tabelle qui.

</details>

Ancora:

<a id="ai-thesis-fit"></a>

[Vai all'adeguatezza della tesi sull'IA](#ai-thesis-fit)

Segnaposto nei modelli

Nei modelli usiamo:

  • [ ] — "compila"
  • — / — — "— / non applicabile" (quando ha senso)
  • YYYY‑MM‑DD — formato della data
  • Tier‑1/2/3 — livello della fonte (prove/contesto/rumore)

Errori comuni

  • Mescolare infobox e descrizione: l'infobox serve solo per fatti brevi; le spiegazioni vanno nel corpo della pagina.
  • Scrivere senza fonti dove dovrebbe esistere una fonte.
  • Sovraccaricare la "prima schermata": i dettagli lunghi sono posizionati meglio all'interno di <details>.
  • Usare "linguaggio finanziario" (consigli di acquisto/vendita/mantenimento, previsioni) — è vietato per noi; scriviamo fatti/rischi/cosa verificare.

Mini checklist prima della pubblicazione

  • Ci sono 1-2 righe che spiegano "cos'è"?
  • Ci sono link a fonti primarie?
  • Ci sono campi della tabella vuoti e "poco chiari" (ognuno deve essere un valore o —/—)?
  • Last verified (Ultima verifica) è compilato?

No comments to display

Back to top