> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/it/articoli-approfonditi/32-markdown-into-latex-with-style.md). # Markdown in LaTeX con stile **Aggiornamento post-pubblicazione** (13 maggio 2017): Siamo grati a Vít Novotný, l'autore/manutentore del `markdown` pacchetto, per averci scritto fornendoci alcuni utili feedback riguardo all'articolo originale. Siamo lieti di pubblicare questa versione aggiornata che tiene conto delle sue indicazioni e suggerimenti, e li include. ### Introduzione Qualche tempo fa abbiamo salutato con gioia il rilascio del [`pacchetto markdown`](http://www.ctan.org/pkg/markdown) che ha reso possibile scrivere sintassi markdown nei documenti LaTeX—e lo abbiamo celebrato con un articolo intitolato [Come scrivere in Markdown su Overleaf](/latex/it/articoli-approfonditi/30-how-to-write-in-markdown-on-overleaf.md) il cui scopo era dimostrare alcune delle sintassi supportate. **Ricorda**: Dovrai compilare i tuoi `.tex` file con l' `--shell-escape` opzione per farlo funzionare sulle installazioni locali di LaTeX—Overleaf lo fa per te (automaticamente). Tieni presente che la maggior parte dei portali di invio per riviste non abilita `--shell-escape`—a meno che tu non sia autorizzato a caricare solo il PDF finale del manoscritto, i tuoi file LaTeX contenenti markdown potrebbero non compilarsi correttamente quando vengono elaborati dal sistema di invio dell'editore. Una delle idee suggerite nel [articolo precedente](/latex/it/articoli-approfonditi/30-how-to-write-in-markdown-on-overleaf.md) è che una combinazione di markdown e LaTeX consente una meravigliosa separazione tra contenuto e stile. Gli autori (soprattutto quelli già familiari con markdown) avrebbero una sintassi molto più concisa con cui lavorare (con alcune avvertenze), pur avendo ancora accesso a tutte le meraviglie dei pacchetti e dei template LaTeX per occuparsi dello stile e della formattazione. Quella [articolo precedente](/latex/it/articoli-approfonditi/30-how-to-write-in-markdown-on-overleaf.md) mostrava alcuni esempi di utilizzo di markdown in [presentazioni Beamer](https://www.overleaf.com/read/dnrwnjrpjjhw) e [poster](https://www.overleaf.com/read/jtbgmmgqrqmh): oggi vedremo possibilità di formattazione ancora più divertenti ed entusiasmanti! ### Usare markdown in template LaTeX stilizzati Oltre agli esempi sopra, puoi usare markdown in quasi tutti i template. Ecco alcuni rapidi esempi: * Il [Legrange orange book](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) modello * Il [dispensa ispirata a Tufte](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) modello * Questo [template per articolo molto bello](https://www.overleaf.com/read/xfsrpsmdtqvt) di Thiago Potresti notare che due di questi sono template per articoli e uno è un template per libro. Il [`pacchetto markdown`](http://www.ctan.org/pkg/markdown) rileva se il `\chapter` comando è disponibile per l'uso in un particolare documento LaTeX e farà sì che l'intestazione di primo livello `markdown` venga resa in `\chapter` o `\section` in modo appropriato. ### Dispense velocissime: markdown + pocketmod Dal momento in cui ho imparato per la prima volta cosa fosse markdown, mi è sembrato un modo rapido e conveniente per prendere appunti: riflette il modo in cui potrei scarabocchiare note su ritagli di carta o post-it—soprattutto con la sintassi per gli elenchi puntati e numerati. Quando ho creato per la prima volta il [template PocketMod](https://www.overleaf.com/read/nqbhpnrkskrx) nel 2015, desideravo un modo per scrivere markdown in LaTeX così da poter creare PocketMod *con* markdown perché mi sembrava… appropriato. Annotare note in una semplice sintassi su piccoli libretti piegati, ma con una tipografia piacevole—alcuni si riferiscono ai PocketMod come "zine" perché sono piccoli libretti di 8 pagine che puoi ricavare da un singolo foglio di carta A4. E infatti era possibile! Questo rende piuttosto facile produrre rapidamente un [mini-libretto pianificatore settimanale](https://www.overleaf.com/read/zfzcxygqwqsq) o un piccolo [libro di storie illustrato](https://www.overleaf.com/read/rppnsfgnrhsf). Sì, era divertente per mia figlia vedere un libro di storie fatto con i suoi stessi disegni… beh, per ben 10 minuti! Il [`pacchetto markdown`](http://www.ctan.org/pkg/markdown) ti permette di personalizzare il modo in cui ogni sintassi markdown viene resa in LaTeX, quindi ho ridefinito la sintassi standard `![](img_file "caption")` per mettere la didascalia sotto il file immagine (senza alcun prefisso "Figura" o numerazione), e poi ho inserito un'interruzione di pagina. Questo rende ancora più facile realizzare il libro illustrato. Ecco un video che mostra come piegare il libretto: {% embed url="" %} ### Libretti di ricette semplici Se ci pensi, una ricetta è composta da elenchi: un elenco di ingredienti, un elenco di istruzioni di preparazione o cottura e forse un elenco di note (tempo di cottura, porzioni, ecc.). Quindi, invece di scrivere questo: ```latex \begin{enumerate} \item Per prima cosa fai questo \item Poi fai quello ... \end{enumerate} ``` Apprezzerei sicuramente poter scrivere questo: ``` #. Per prima cosa fai questo #. Poi fai quello ``` E allo stesso modo per gli ingredienti: ``` - 2 uova - un pizzico di sale ``` Quindi, per produrre facilmente una ricetta veloce possiamo scrivere questo: ``` # Uova strapazzate Tempo di cottura : 5 minuti Porzioni : 1 ## Ingredienti - 4 uova - 1 cucchiaino di burro - 1/4 di tazza di latte - sale, pepe (a piacere) ## Istruzioni #. Sbatti le uova, il latte... #. Scalda il burro in padella... #. ... ``` Hmm, sembra promettente. Alcuni di noi di Overleaf (e le nostre famiglie) hanno contribuito con le nostre ricette rapide preferite (ideali per chi cucina per la prima volta) e io ho messo insieme (scusate il gioco di parole) un [template per ricette veloci](https://www.overleaf.com/read/gscqdhnwzsfg) che puoi scrivere con markdown *e* per trasformarlo in un mini-libretto. [![A recipe booklet produced on Overleaf using markdown](/files/37e1fe71cd5bd5dc776089da103f41bf329a031e)](https://www.overleaf.com/read/gscqdhnwzsfg) Ora arriva un altro po' di divertimento. Sotto il cofano questo è ancora LaTeX, quindi possiamo continuare a stilizzare i vari elementi—titoli di sezione, elenchi puntati, font e così via—usando il solito arsenale di trucchi di LaTeX. Fu allora che mi lasciai un po' prendere la mano e arrivai a *tre* "temi" per la classe `simple-recipe` ! ### Bonus 1: Alcune avvertenze quando si usa il pacchetto markdown * SyncTeX non funzionerà del tutto. Su Overleaf, questo significa che le operazioni "position in preview" e "click-in-preview-to-jump-to-source" non funzioneranno nelle `markdown` regioni. * `\\` perde il suo significato normale: il consueto trucco del "due spazi seguiti da una nuova riga" `markdown` non funziona qui perché gli spazi finali verranno rimossi dal parser Lua, come documentato nella [`markdown` documentazione del pacchetto](http://texdoc.net/pkg/markdown). `\newline` funzionerà comunque, però. * Fai attenzione a più caratteri di sottolineatura sulla stessa riga—questo può essere un problema se: * lavori con molti pedici nelle tue equazioni (suggerimento: esci dall' `markdown` ambiente in questi casi); * ti piace usare i caratteri di sottolineatura nelle chiavi BibTeX. Puoi impostare `underscores=false` con i file `pacchetto markdown` più recenti per far funzionare i sottolineati come pedici, ma non funzionerà comunque con i sottolineati nelle chiavi BibTeX. **Aggiornamento** (13 maggio 2017): I sottolineati nelle chiavi BibTeX funzioneranno con `markdown` dalla v2.5.2 in poi—grazie Vít! * Avrai qualche difficoltà a visualizzare un carattere cancelletto letterale perché nemmeno `\#` funzionerà! Di solito definisco un nuovo comando e uso quello al suo posto. ### Bonus 2: Nuove funzionalità nel pacchetto markdown aggiornato `markdown` La v2.4 e le versioni successive hanno aggiunto il supporto per una sintassi davvero bella: * **Sintassi per note a piè di pagina in linea**: `...^[questa è la nota a piè di pagina]` (richiede l' `inlineFootnotes` opzione) * **Citazioni:**`[@smith1990]` (richiede l' `citazioni` opzione; fai anche attenzione ai sottolineati nelle tue chiavi BibTeX!) * **Codice delimitato**: Puoi usare sia le tilde `~` o i backtick `` ` `` come delimitatore. ``` ~~~~ int main() { cout << "Hello world!"; return 0; } ~~~~ ``` Se vuoi usare queste nuove funzionalità, assicurati di caricare versioni aggiornate di `markdown.lua`, `markdown.tex` e `markdown.sty` nel tuo progetto—oppure puoi semplicemente creare un nuovo progetto da [questo template](https://www.overleaf.com/read/whdrnpcpnwrm). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/it/articoli-approfonditi/32-markdown-into-latex-with-style.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.