Sintassi delle Citazioni
Le citazioni vengono utilizzate per evidenziare testo citato o enfatizzare informazioni importanti. In Markdown, usa il simbolo >
per creare blocchi di citazione.
Sintassi Base delle Citazioni
Citazione su una sola riga
Usa il simbolo >
all'inizio di una riga per creare una citazione:
> Questa è una citazione.
Risultato Renderizzato:
Questa è una citazione.
Citazione su più righe
> Questa è la prima riga della citazione.
> Questa è la seconda riga della citazione.
> Questa è la terza riga della citazione.
Risultato Renderizzato:
Questa è la prima riga della citazione. Questa è la seconda riga della citazione. Questa è la terza riga della citazione.
Paragrafi nelle Citazioni
Includi più paragrafi in una citazione:
> Questo è il primo paragrafo della citazione.
>
> Questo è il secondo paragrafo della citazione.
Risultato Renderizzato:
Questo è il primo paragrafo della citazione.
Questo è il secondo paragrafo della citazione.
Citazioni Annidate
Annidamento Base
Usa >>
per creare citazioni annidate:
> Questa è la citazione di primo livello.
>
> > Questa è la citazione di secondo livello.
>
> Torna alla citazione di primo livello.
Risultato Renderizzato:
Questa è la citazione di primo livello.
Questa è la citazione di secondo livello.
Torna alla citazione di primo livello.
Annidamento su più livelli
> Citazione livello 1
> > Citazione livello 2
> > > Citazione livello 3
> > > > Citazione livello 4
> >
> > Torna al livello 2
>
> Torna al livello 1
Risultato Renderizzato:
Citazione livello 1
Citazione livello 2
Citazione livello 3
Citazione livello 4
Torna al livello 2
Torna al livello 1
Altri Elementi nelle Citazioni
Formattazione nelle Citazioni
> **Testo in grassetto** e *testo in corsivo* funzionano normalmente nelle citazioni.
>
> Puoi usare `codice inline` e altra formattazione.
Risultato Renderizzato:
Testo in grassetto e testo in corsivo funzionano normalmente nelle citazioni.
Puoi usare
codice inline
e altra formattazione.
Titoli nelle Citazioni
> ## Titolo nella Citazione
>
> Questo è il contenuto principale nella citazione.
>
> ### Sottotitolo
>
> Altro contenuto citato.
Risultato Renderizzato:
Titolo nella Citazione
Questo è il contenuto principale nella citazione.
Sottotitolo
Altro contenuto citato.
Liste nelle Citazioni
> Lista nella citazione:
>
> 1. Primo elemento
> 2. Secondo elemento
> 3. Terzo elemento
>
> Oppure lista non ordinata:
>
> - Elemento A
> - Elemento B
> - Elemento C
Risultato Renderizzato:
Lista nella citazione:
- Primo elemento
- Secondo elemento
- Terzo elemento
Oppure lista non ordinata:
- Elemento A
- Elemento B
- Elemento C
Blocchi di Codice nelle Citazioni
> Ecco un esempio di codice:
>
> ```javascript
> function hello() {
> console.log("Ciao, Mondo!");
> }
> ```
>
> I blocchi di codice vengono visualizzati correttamente anche nelle citazioni.
Risultato Renderizzato:
Ecco un esempio di codice:
javascriptfunction hello() { console.log("Ciao, Mondo!"); }
I blocchi di codice vengono visualizzati correttamente anche nelle citazioni.
Link nelle Citazioni
> Consulta la [documentazione ufficiale](https://www.markdownlang.com) per maggiori informazioni.
>
> Puoi anche visitare <https://www.markdownlang.com> per un link diretto.
Risultato Renderizzato:
Consulta la documentazione ufficiale per maggiori informazioni.
Puoi anche visitare https://www.markdownlang.com per un link diretto.
Scenari d'Uso Comuni
1. Citazione Letteraria
> "Markdown è un linguaggio di markup leggero che permette di scrivere documenti in un formato di testo semplice da leggere e scrivere."
>
> — John Gruber, creatore di Markdown
Risultato Renderizzato:
"Markdown è un linguaggio di markup leggero che permette di scrivere documenti in un formato di testo semplice da leggere e scrivere."
— John Gruber, creatore di Markdown
2. Messaggio di Avviso
> ⚠️ **Avviso**
>
> Questa azione eliminerà tutti i dati. Assicurati di eseguire il backup dei file importanti.
Risultato Renderizzato:
⚠️ Avviso
Questa azione eliminerà tutti i dati. Assicurati di eseguire il backup dei file importanti.
3. Messaggio di Suggerimento
> 💡 **Suggerimento**
>
> Usa la scorciatoia `Ctrl+S` per salvare rapidamente il documento.
Risultato Renderizzato:
💡 Suggerimento
Usa la scorciatoia
Ctrl+S
per salvare rapidamente il documento.
4. Nota Importante
> 📌 **Nota Importante**
>
> Prima di iniziare, assicurati di aver installato le seguenti dipendenze:
>
> - Node.js (>= 14.0)
> - npm (>= 6.0)
> - Git
Risultato Renderizzato:
📌 Nota Importante
Prima di iniziare, assicurati di aver installato le seguenti dipendenze:
- Node.js (>= 14.0)
- npm (>= 6.0)
- Git
Errori Comuni e Soluzioni
1. Simbolo > Mancante
❌ Errato:
> Prima riga della citazione
Seconda riga senza simbolo > ← Questa riga non sarà inclusa nella citazione
✅ Corretto:
> Prima riga della citazione
> Seconda riga correttamente citata
2. Errore di Livello di Annidamento
❌ Errato:
> Livello 1
> > > Passato direttamente al livello 3 ← Saltato livello 2
✅ Corretto:
> Livello 1
> > Livello 2
> > > Livello 3
3. Gestione delle Righe Vuote
❌ Potenziale problema:
> Primo paragrafo
> Secondo paragrafo ← Questo crea due citazioni separate
✅ Corretto per citazione multi-paragrafo:
> Primo paragrafo
>
> Secondo paragrafo
Best Practice
1. Mantieni lo Stile Coerente
✅ Consigliato: Stile di citazione unificato
> Tutte le informazioni importanti usano le citazioni
> Mantieni la formattazione coerente
❌ Non consigliato: Uso misto
> A volte usa la citazione
**A volte usa il grassetto invece**
2. Usa l'Annidamento in Modo Appropriato
✅ Consigliato: Annidamento semplice e chiaro
> Punto principale
> > Argomento di supporto
>
> Continua punto principale
❌ Non consigliato: Annidamento troppo profondo
> > > > > Troppo profondo, difficile da leggere
3. Usa Semanticamente
✅ Consigliato: Citazioni significative
> Questa è un'informazione importante da un documento autorevole
❌ Non consigliato: Citazioni decorative
> Questo è solo testo normale, non serve la formattazione di citazione
Output HTML
Le citazioni Markdown vengono convertite in HTML:
> Questo è testo citato
Diventa:
<blockquote>
<p>Questo è testo citato</p>
</blockquote>
Citazioni annidate:
> Livello 1
> > Livello 2
Diventa:
<blockquote>
<p>Livello 1</p>
<blockquote>
<p>Livello 2</p>
</blockquote>
</blockquote>
Stili Personalizzati
Alcuni processori Markdown supportano stili personalizzati per le citazioni:
Avvisi in Stile GitHub
> [!NOTE]
> Questa è una nota informativa
> [!WARNING]
> Questa è una nota di avviso
> [!IMPORTANT]
> Questa è una nota importante
Utilizzo di HTML e CSS
<blockquote style="border-left: 4px solid #3498db; padding-left: 1em; color: #7f8c8d;">
Questa è una citazione con stile personalizzato
</blockquote>
Esempi Pratici
Esempio in Documentazione API
## Autenticazione Utente
L'autenticazione utente è un passaggio necessario per accedere all'API.
> **Metodo di Autenticazione**
>
> La nostra API utilizza Bearer Token per l'autenticazione:
>
> ```bash
> curl -H "Authorization: Bearer YOUR_TOKEN" \
> https://api.example.com/users
> ```
### Esempio di Richiesta
Invia una richiesta POST per creare un utente:
> ```json
> {
> "name": "Mario Rossi",
> "email": "mario@example.com",
> "role": "user"
> }
> ```
Note nei Tutorial
## Passaggi di Installazione
1. Scarica l'installer
2. Esegui l'installer
> ⚠️ **Nota**
>
> Prima dell'installazione, assicurati che:
> - L'antivirus sia disattivato
> - Esegui come amministratore
> - Il disco di sistema abbia almeno 2GB di spazio libero
3. Completa la procedura guidata di installazione
Sintassi Correlata
- Sintassi Enfasi - Formattazione del testo
- Sintassi Liste - Liste di elementi
- Sintassi Codice - Formattazione del codice
- Sintassi Link - Creazione di collegamenti
Pratica
Prova a creare quanto segue:
- Una citazione con più paragrafi
- Una struttura di citazione annidata a tre livelli
- Una citazione tecnica con un esempio di codice
- Una citazione annidata che simula una conversazione