Per impedire che il testo dopo un blocco di codice Markdown diventi codice, rimuovi la tabulazione iniziale o i quattro spazi di indentazione. Se vuoi anche un rientro visibile del paragrafo in Obsidian sul Mac, lascia il Markdown non indentato e applica la spaziatura con i CSS.

Perché il paragrafo diventa un altro blocco di codice?

La chiusura di un blocco di codice delimitato termina quel blocco, ma non disattiva la sintassi di indentazione per il testo sottostante. Al livello principale, quattro o più spazi iniziali possono avviare un blocco di codice indentato separato. L’esempio seguente contiene quindi due blocchi di codice, anche se solo il primo ha i delimitatori. CommonMark: blocchi di codice indentati.

```text
Sample output
```

    This should be a normal paragraph.

La distinzione importante è se il testo indesiderato appartiene al blocco delimitato originale oppure avvia un nuovo blocco. Se il delimitatore di chiusura è ancora visibile nel codice, controlla che usi lo stesso carattere del delimitatore di apertura e contenga almeno altrettanti backtick o tilde. Per un blocco al livello principale, colloca entrambi i delimitatori sul margine sinistro per facilitare il controllo. GitHub Flavored Markdown: blocchi di codice delimitati.

L’aggiunta di righe vuote non neutralizza l’indentazione di quattro spazi. Al contrario, il testo indentato subito dopo un normale paragrafo può rimanere parte di quel paragrafo, perché un blocco di codice indentato non può interromperlo. Questo spiega perché un’indentazione apparentemente simile a volte si comporta diversamente in un’altra parte della nota. CommonMark: blocchi di codice indentati.

Come ripristinare un normale paragrafo sul Mac?

In Obsidian, passa alla Modalità sorgente per esaminare i delimitatori effettivi e gli spazi iniziali. Usa il controllo della modalità di modifica nella barra di stato oppure scegli Impostazioni → Editor → Modalità di modifica predefinita → Modalità sorgente. Obsidian descrive questa modalità come quella che mostra la sintassi Markdown esattamente come è stata scritta. Visualizzazioni e modalità di modifica.

Individua la prima riga di testo dopo il delimitatore di chiusura. Elimina gli spazi o la tabulazione iniziali, lasciando il testo sul margine sinistro. Ripeti l’operazione per gli eventuali paragrafi successivi con lo stesso problema. Mantieni l’indentazione all’interno del blocco di codice previsto.

Usa questo esempio completo di Markdown come riferimento:

```text
Sample output
```

This is a normal paragraph with **bold text**.

This is another normal paragraph.

Mantieni la riga vuota dopo il delimitatore di chiusura per rendere il sorgente più leggibile. GitHub raccomanda esplicitamente righe vuote intorno ai blocchi di codice delimitati, anche se la sintassi dei delimitatori non le richiede. I delimitatori esterni di quattro backtick usati per mostrare gli esempi in questo articolo consentono di visualizzare i backtick tripli interni. Creazione e formattazione dei blocchi di codice.

Passa alla Vista di lettura per controllare il risultato; su macOS, Cmd+E alterna la modalità di modifica e quella di lettura. Verifica che la spiegazione abbia la formattazione di un normale paragrafo e che il testo in grassetto appaia in grassetto. L’Anteprima dal vivo nasconde gran parte della sintassi Markdown e la mostra intorno al cursore: usa quindi la Modalità sorgente per individuare il problema e la Vista di lettura per il controllo visivo finale. Visualizzazioni e modalità di modifica.

Rimuovere solo due spazi da un’indentazione di quattro può impedire l’interpretazione come codice al livello principale, ma non crea un rientro visibile del paragrafo. Obsidian documenta che gli spazi normali adiacenti vengono ridotti a uno nel testo visualizzato. L’indentazione nel sorgente e quella visibile sono due requisiti diversi. Sintassi di base per la formattazione.

Come mantenere un rientro visibile del paragrafo in Obsidian?

Per rientrare la prima riga, usa paragrafi normali insieme a uno snippet CSS. In questo modo la struttura del paragrafo resta distinta dalla presentazione: il Markdown rimane leggibile e il CSS fornisce la spaziatura visiva. Obsidian supporta snippet personalizzati e una proprietà cssclasses per applicare uno stile a note selezionate. Snippet CSS.

Il seguente è un esempio illustrativo di stile personalizzato, basato sul meccanismo delle classi documentato da Obsidian e sull’indentazione CSS dei paragrafi. Non è un comando di formattazione integrato in Obsidian. Si applica agli elementi paragrafo visualizzati; controllane l’aspetto nella Vista di lettura.

Aggiungi la proprietà alla nota e il foglio di stile

Inserisci questo blocco di proprietà all’inizio della nota. Se la nota ha già un blocco di proprietà, aggiungi lì cssclasses invece di crearne un secondo. Lascia non indentato il testo dopo il blocco di codice.

---
cssclasses:
  - paragraph-indent
---

Crea un file di testo semplice chiamato paragraph-indent.css con questo foglio di stile completo:

.paragraph-indent p {
  text-indent: 2em;
}

Il selettore p individua i paragrafi all’interno della classe personalizzata della nota. La proprietà text-indent rientra la prima riga; le righe successive a capo mantengono la posizione iniziale normale. Il valore 2em è un esempio che puoi modificare. Non inserisce spazi nella nota. MDN: text-indent.

Sul Mac, usa un editor di testo semplice per il foglio di stile. Se usi TextEdit, scegli Formato → Converti in testo semplice prima di salvare. Verifica che il nome finale del file sia paragraph-indent.css, non un documento RTF né un file con estensione .css.txt. Apple documenta che la conversione in testo semplice rimuove la formattazione del documento e che di norma il file viene salvato con estensione .txt. Creare, aprire e convertire documenti in TextEdit sul Mac.

  1. In Obsidian, apri Impostazioni → Aspetto → Snippet CSS.
  2. Seleziona Apri la cartella degli snippet e inserisci lì paragraph-indent.css.
  3. Se il file non compare nell’elenco, seleziona Ricarica gli snippet.
  4. Attiva l’interruttore dello snippet e poi controlla la nota nella Vista di lettura. Snippet CSS.

Questo esempio generale rientra ogni paragrafo visualizzato corrispondente all’interno della nota selezionata, compresi i paragrafi in altre strutture. L’effetto non è limitato al paragrafo immediatamente successivo a un blocco di codice. Per annullare lo stile, disattiva lo snippet oppure rimuovi dalla nota la classe paragraph-indent.

Il foglio di stile non corregge il testo che viene ancora interpretato come codice: il selettore individua i paragrafi. Correggi prima gli spazi. Inoltre, questo selettore per i paragrafi non fornisce uno stile completo per l’editor dell’Anteprima dal vivo; non aspettarti che la visualizzazione nell’editor e quella di lettura siano identiche.

Cosa cambia all’interno di un elenco o su GitHub?

L’indentazione all’interno di un elenco stabilisce l’appartenenza all’elemento dell’elenco. Non rimuoverla indiscriminatamente. In questo esempio completo, il delimitatore e la spiegazione hanno tre spazi iniziali, in modo da allinearsi al contenuto dopo 1. . La spiegazione resta un paragrafo all’interno di quell’elemento. GitHub Flavored Markdown: elementi dell’elenco.

1. Review the sample.

   ```text
   Sample output
   ```

   This explanation belongs to the same list item.

Per altri simboli di elenco, calcola l’indentazione di continuazione in base al simbolo e agli spazi che lo seguono. Un’istruzione generica di rimuovere tutta l’indentazione comprometterebbe la struttura prevista. Se la spiegazione deve trovarsi fuori dall’elenco, riportala invece sul margine sinistro. GitHub Flavored Markdown: elementi dell’elenco.

Obsidian documenta il supporto per CommonMark e GitHub Flavored Markdown, oltre alle proprie estensioni. Questo non rende uno snippet CSS di Obsidian una formattazione Markdown trasferibile: lo snippet va configurato separatamente in Obsidian. Quando sposti una nota, controlla il renderer di destinazione effettivo. Obsidian documenta anche che il Markdown all’interno degli elementi HTML non viene elaborato; un contenitore HTML modifica quindi le condizioni di formattazione, invece di fornire una soluzione universale. Markdown di Obsidian.

Quale soluzione dovresti scegliere?

Usa la modifica più piccola che soddisfa il risultato desiderato:

  • Testo normale dopo il codice: rimuovi la tabulazione iniziale o l’indentazione di quattro spazi del paragrafo.
  • Un paragrafo all’interno di un elemento dell’elenco: mantieni l’indentazione necessaria per il contenuto dell’elemento.
  • Un rientro visibile della prima riga in Obsidian: usa testo non indentato con l’esempio CSS circoscritto.
  • Un documento visualizzato in più app: mantieni chiara la struttura Markdown e verifica separatamente la presentazione in ogni destinazione.

Quando controlli la nota finita, poniti due domande: il testo viene interpretato come paragrafo? E quel paragrafo ha la spaziatura desiderata? Correggi prima la struttura Markdown. Poi applica il rientro visivo dove il renderer lo supporta, mantenendo il foglio di stile separato dal testo.

Fonti