Questa è una guida personale alla formattazione e allo stile di scrittura dei contenuti, adatta per l'assistenza alla scrittura tramite IA, la configurazione di competenze o la citazione di istruzioni.

---

## Linee guida di base per la formattazione

### Testo misto cinese e inglese

Aggiungi uno spazio tra il cinese e l'inglese, ad esempio: `Use Notion to manage tasks`.

- Aggiungere uno spazio tra i caratteri cinesi e i numeri, ad esempio: `soddisfare il 90% dei requisiti`.

- Non inserire spazi tra lettere inglesi e numeri, ad esempio: `iOS 26`.

- Mantenere il nome completo del prodotto o il nome proprio in inglese così com'è, ad esempio: `ChatGPT`, `YouTube`.

### Segni di punteggiatura

- Nei contesti cinesi, utilizzare "" invece di "", ad esempio: `Dopo essere passato alla "visualizzazione divisa"`.

In ambito inglese, si usano normalmente le virgolette doppie `""`.

- Quando gli utenti usano le virgolette doppie inglesi per racchiudere simboli o punteggiatura inglesi a scopo di enfasi (come `", "` "." " / "), lasciatele così come sono e non sostituitele con simboli cinesi.

- Per i puntini di sospensione si usano `……` (cinese) o `...` (inglese), non si possono mescolare.

- Aggiungere un punto alla fine di ogni elemento dell'elenco strutturato (punti, passaggi). La punteggiatura nei paragrafi del corpo del testo deve seguire il testo originale e non deve essere modificata.

- Non spezzare forzatamente le frasi lunghe unite da virgole in frasi più brevi. Le proposizioni separate da virgole seguono il ritmo normale in cinese; lasciale così come sono.

- Cerca di evitare l'uso dei trattini `——`.

### Numeri e unità

- I numeri puri utilizzano cifre arabe: `3 concetti`, `55 caratteri`.

- Importo con simbolo di valuta: `1 milione di dollari USA ARR`.

- Utilizzare `%` al posto di "percentuale".

---

## Struttura e gerarchia

### Livello di intestazione

- `##` viene utilizzato per i titoli dei capitoli principali.

- `###` viene utilizzato per i titoli delle sottosezioni.

- Non utilizzare `#` per le intestazioni di primo livello (il titolo della pagina è già un'intestazione di primo livello).

- Per i titoli, utilizzate sostantivi o frasi brevi, non frasi complete.

### Separazione e ritmo

- Utilizzare i separatori `---` per separare sezioni di contenuto di grandi dimensioni.

- Utilizza le intestazioni per suddividere le sezioni all'interno di un modulo e non riutilizzare le linee di separazione.

- Mantenere interruzioni di riga naturali tra i paragrafi; non sono necessari blocchi di righe vuote.

### Elenco

- Utilizzare un elenco non ordinato `-` per i punti paralleli.

- Utilizzare un elenco ordinato `1. 2. 3.` per sequenze o passaggi.

- Mantieni gli elementi dell'elenco concisi, con ogni elemento che esprima un singolo punto.

- La nidificazione è supportata, ma fino a un massimo di due livelli.

---

## Enfasi e formattazione

### Grassetto

- Utilizza il **grassetto** per evidenziare i concetti chiave, le conclusioni principali o i termini importanti.

- Ad esempio: `il nucleo è costituito da tre elementi: **liste, attività e tag**`.

- Non mettere in grassetto l'intero paragrafo, ma solo le parole chiave.

### Callout

- Utilizzato per suggerimenti, note o informazioni aggiuntive.

- Utilizzare il colore `gray_bg` quando si abbina alle icone emoji.

### Attiva/Disattiva

- Utilizzato per contenuti non essenziali come contenuti opzionali, approfondimenti e confronti tra diverse versioni.

- Evita di nascondere informazioni critiche nell'interruttore.

---

## Stile linguistico

### Principi fondamentali

- **Semplice:** Esprimiti chiaramente con il minor numero di parole possibile.

- **Semplice:** Senza fronzoli e diretto, come parlare con un amico.

- **Precisione**: Ogni parola ha uno scopo ben definito, evitando espressioni vaghe.

### Parole vietate

L'uso dei seguenti termini gergali e metafore vaghe è **severamente vietato**:

- Maniglie, granularità, forza, base, potenziamento, tattiche, collegamenti, mentalità, allineamento, integrazione, ciclo chiuso, sedimentazione.

- Qualsiasi parola che suoni come una presentazione PowerPoint.

### Esempi alternativi

| ❌ Non scriverlo così | ✅ Modificalo così |

| --- | --- |

| Recupera le migliori pratiche | Raccogli metodi utili |

| Dare potere ai creatori | Aiutare i creatori a migliorare |

| Conquista la fiducia degli utenti | Fai in modo che gli utenti si ricordino di te |

| Migliorare la granularità | Scrivere in modo più dettagliato |

| Creare un ciclo chiuso | Eseguire l'intero processo senza intoppi |

### Preferenza sulla struttura della frase

- Frasi prevalentemente brevi, ciascuna delle quali veicola un singolo significato.

- Utilizzare meno spesso la forma passiva; indicare direttamente chi ha fatto cosa.

- Evita di usare cliché come "Vale la pena menzionarlo" o "Come tutti sappiamo"

---

## Guida rapida

✅

**Lista di controllo per la formattazione**

- [ ] Tra i numeri inglesi e cinesi sono presenti degli spazi.

- [ ] Le virgolette cinesi dovrebbero essere "" invece di "".

- [ ] Non è comparso alcuno slang vietato su internet.

- [ ] La gerarchia dei titoli è chiara e non ci sono livelli saltati.

- [ ] Il testo in grassetto è utilizzato solo per le parole chiave e non deve essere usato eccessivamente.

- [ ] Gli elementi dell'elenco sono concisi, ciascuno dei quali trasmette un singolo significato.

- [ ] Il linguaggio è semplice e diretto, senza cliché.