> 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/30-how-to-write-in-markdown-on-overleaf.md).
# Come scrivere in Markdown su Overleaf
**Aggiornamento dopo la pubblicazione** (aggiunto il 13 maggio 2017): Siamo grati a Vít Novotný, l'autore/manutentore del `markdown` pacchetto, per averci scritto con alcuni utili commenti riguardo all'articolo originale. Siamo lieti di pubblicare questa versione aggiornata che tiene conto dei suoi consigli e suggerimenti e li include.
### Eh, cosa?
[Markdown](https://kirkstrobeck.github.io/whatismarkdown.com/) è un linguaggio di markup leggero (capito? 😉) che ti permette di scrivere qualcosa in testo semplice con alcune *molto* regole semplici, e poi trasformarlo in output formattati, ad es. HTML. È molto popolare tra sviluppatori e programmatori, proprio per la sua semplicità (e oserei aggiungere, perfetto anche per prendere appunti!).
Per esempio, per scrivere velocemente una lista della spesa:
```
# Lista della spesa
*Ricorda* di prendere più cose possibile durante i prossimi [saldi](http://acme-marg.com)!
## Cibo
- fagioli al forno
- spaghetti
## Cancelleria
- blocco per scrivere
- matite
```
E otterrai come output HTML, usando uno strumento come [pandoc](http://pandoc.org/):
```html
Lista della spesa
Ricorda di prendere più cose possibile durante i prossimi saldi!
Cibo
- fagioli al forno
- spaghetti
Cancelleria
- blocco per scrivere
- matite
```
Bello e semplice! Puoi trovare altra sintassi per Markdown [qui](https://daringfireball.net/projects/markdown/syntax).
### Quindi cosa significa per me?
Molti utenti di LaTeX sono soddisfatti dei loro splendidi documenti impaginati in LaTeX, ma non possono fare a meno di provare un pizzico d'invidia verso gli utenti di Markdown—perché, beh, il markup LaTeX *può* a volte diventa piuttosto prolisso. Sì, liste, stiamo parlando di *voi*...
La buona notizia è che il fantastico nuovo [`markdown` pacchetto LaTeX](https://ctan.org/pkg/markdown) ti consente di scrivere sintassi markdown nei tuoi documenti LaTeX (cioè input più semplici) e ottenere comunque PDF splendidamente impaginati! Tutto ciò che devi fare è caricare il `markdown` pacchetto nel tuo documento, e racchiudere il tuo materiale Markdown dentro un `markdown` ambiente:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\begin{markdown}
# Lista della spesa
*Ricorda* di prendere più cose possibile durante i prossimi [saldi](http://acme-marg.com)!
## Cibo
- fagioli al forno
- spaghetti
## Cancelleria
- blocco per scrivere
- matite
\end{markdown}
\end{document}
```
Oppure, se preferisci inserire il tuo materiale Markdown in un `*.md` file:
```latex
\documentclass{article}
\usepackage{markdown}
\begin{document}
\markdownInput{example.md}
\end{document}
```
Fantastico! Molto probabilmente questo renderà felicissimi i tipi da sviluppatore, perché ora possono semplicemente copiare la loro `.md` documentazione!
### Posso ancora usare comandi LaTeX se scrivo in Markdown?
Sì, puoi ancora usare comandi LaTeX nel tuo materiale Markdown! Basta passare il `ibrido` opzione su `markdown`:
```latex
\usepackage[hybrid]{markdown}
...
- blocco per scrivere (quello con il grande $E=mc^2$ sulla copertina)
```
### Come posso usare caratteri letterali come '#' e '\_' (trattini bassi)?
#### Digitare un '#'
Non puoi digitare il carattere '#' *all'interno dell' `markdown` ambiente*. Neppure `\#` funzionerà. Devi definire un comando come `\newcommand{\texthash}{\#}`e poi usare `\texthash` nel preambolo dei tuoi `markdown` ambiente. Lo stesso vale per i trattini bassi, soprattutto quando ce n'è più di uno sulla stessa riga, ad es. `$y = m_1 + n_2$`. A volte può essere più semplice terminare l'attuale `markdown` ambiente e scrivere le righe problematiche in modalità LaTeX normale, e poi iniziarne un altro `markdown` .
#### Digitare '\_' (trattino basso) e '\`' (backtick)
**Aggiornamento** (aggiunto il 13 maggio 2017): Dalla `markdown` versione 2.5 puoi impostare `underscores = false` e `codeSpans = false` per disattivare i trattini bassi e i backtick. Questo rende possibile scrivere pedici matematici e virgolette in modalità ibrida senza escape. Abbiamo gli asterischi per l'enfasi, quindi l'unica cosa davvero perduta sono gli esempi di codice inline. Grazie Vít per il suggerimento!
#### Ambienti da evitare...
E anche se puoi usare i backtick per scrivere verbatim inline, oppure indentare la riga con quattro spazi per un blocco verbatim, non usare `lstlisting` né `minted` ambienti LaTeX all'interno di `markdown` ambienti. Proprio no.
#### Usare HTML in un ambiente markdown
E no, non puoi usare HTML all'interno del LaTeX `markdown` ambiente LaTeX (anche se questa è una cosa comune nel Markdown tradizionale). Mi dispiace.
**Aggiornamento** (aggiunto il 13 maggio 2017): A partire da `markdown` v2.3, c'è un `html` opzione che non mostrerà i tag HTML alla lettera se sono presenti nel tuo materiale markdown, anche se non formatterà nemmeno realmente il contenuto dei tag—cioè `Ciao!` mostrerà semplicemente Ciao! in normale. Ma entità HTML come `©` verranno rese come ©. Grazie a Vít per averlo fatto notare.
### Opzioni suggerite per il pacchetto markdown
Un insieme di `markdown` opzioni del pacchetto che potresti trovare utili è:
```latex
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses,hybrid]{markdown}
```
Queste opzioni consentono l'uso della
* sintassi markdown per le note a piè di pagina (come `[^1]`);
* gli elenchi di definizioni e `#` per gli elenchi numerati;
* le ellissi "corrette" (…).
Ecco un [esempio completo](https://www.overleaf.com/latex/examples/using-markdown-in-latex-documents/whdrnpcpnwrm) nella galleria di Overleaf, ed ecco [un altro](https://www.overleaf.com/articles/how-to-write-using-rich-text-format-and-markdown-in-latex-and-overleaf/dbqrxvftzskw).
### Collegamenti ipertestuali e note a piè di pagina: come?
Nell'esempio di Overleaf il collegamento ipertestuale è una nota a piè di pagina. Come posso fare in modo che sia un collegamento hyperref?
`markdown` è personalizzabile, quindi puoi definire come vorresti che i diversi elementi venissero resi. Aggiungerli al preambolo farà esattamente questo:
```latex
\markdownSetup{renderers={
link = {\href{#2}{#1}}
}}
```
**Aggiornamento** (aggiunto il 13 maggio 2017): `rendererPrototypes` è stato usato nella versione iniziale. Agli utenti normali si raccomanda di usare `renderers` per le proprie definizioni, poiché `rendererPrototypes` serve ai creatori del pacchetto per fornire valori predefiniti. Se modifichi `rendererPrototypes`, corri il rischio che un altro pacchetto sovrascriva le tue impostazioni. Grazie a Vít per averlo fatto notare!
### Inclusione di immagini (aggiornato l'8 novembre 2022)
* **Nota**: L'esempio successivo usa un file grafico (`example-image.pdf`) fornito dal `pacchetto mwe` I file grafici sono distribuiti da TeX Live e quindi memorizzati sui server di Overleaf, rendendoli disponibili come segnaposto per immagini, come nell'esempio qui sotto.
Le immagini possono essere incluse nel markdown scrivendo un markup nel seguente formato:
```latex
```
Speriamo che i nomi dei parametri `testo alternativo`, `nome-file` e `"didascalia dell'immagine"` descrivano ciò che fanno. Ecco un esempio per mostrarli:
```latex
\documentclass{article}
\usepackage[hybrid]{markdown}
% Il pacchetto mwe fornisce immagini di esempio. Caricarlo è
% non essenziale perché quelle immagini sono nel percorso di ricerca di LaTeX.
% Qui lo carichiamo per chiarezza in questo esempio.
\usepackage{mwe}
\begin{document}
\begin{markdown}
Questo esempio mostra come importare un file grafico. Qui stiamo usando un'
immagine di esempio fornita dal pacchetto `mwe`.
% Usa \setkeys{Gin} se devi cambiare la dimensione di visualizzazione di un'immagine
\setkeys{Gin}{width=.5\linewidth}
\end{markdown}
\end{document}
```
[Apri questo esempio su Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+images+in+markdown\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bhybrid%5D%7Bmarkdown%7D%0A%25+The+mwe+package+provides+example+images.+Loading+it+is%0A%25+not+essential+because+those+images+are+in+LaTeX%27s+search+path.+%0A%25+Here%2C+we+load+it+for+clarity+in+this+example.%0A%5Cusepackage%7Bmwe%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmarkdown%7D%0AThis+example+shows+how+to+import+a+graphics+file.+Here+we+are+using+an%0Aexample+image+provided+by+the+%60mwe%60+package.%0A%0A%25+Use+%5Csetkeys%7BGin%7D+if+you+need+to+change+an+image%27s+display+size%0A%0A%5Csetkeys%7BGin%7D%7Bwidth%3D.5%5Clinewidth%7D%0A%21%5BThis+is+alt+text+to+describe+my+image.%5D%28example-image.jpg+%22An+example+image+provided+by+the+%5Ctexttt%7Bmwe%7D+package.%22%29%0A%5Cend%7Bmarkdown%7D%0A%5Cend%7Bdocument%7D)
Questo esempio produce il seguente output:
#### Nota sulla larghezza dell'immagine
Come la maggior parte dei pacchetti, `markdown` carica altri pacchetti, incluso [`keyval`](https://ctan.org/pkg/keyval?lang=en) e [`graphicx`](https://ctan.org/pkg/graphicx?lang=en), per utilizzare i comandi e le funzionalità che forniscono. Qui, la larghezza dell'immagine viene impostata usando il `\setkeys` comando, fornito da `keyvals`. `Gin` è una "famiglia" di chiavi definita da `graphicx` pacchetto.
* **Nota**: Poiché un comando LaTeX, qui `\setkeys`, viene usato *all'interno di* il `markdown` ambiente, l'opzione `ibrido` del pacchetto markdown è necessaria.
#### Modifica degli identificatori di posizionamento dei float (più avanzato)
La sintassi markdown per l'inclusione di figure non consente di specificare direttamente gli identificatori di posizionamento dei float, ma puoi ajustarli ridefinendo il modo in cui la figura viene resa:
```latex
\markdownSetup{renderers={
image = {\begin{figure}[hbt!]
\centering
\includegraphics{#3}%
\ifx\empty#4\empty\else
\caption{#4}%
\fi
\end{figure}}
}}
```
Per ulteriori informazioni fai riferimento alla [documentazione markdown](https://mirror.apps.cam.ac.uk/pub/tex-archive/macros/generic/markdown/markdown.html).
### Puoi creare tabelle usando markdown in LaTeX? 😀
Purtroppo no. Le tabelle sono supportate solo in [MultiMarkdown](http://fletcherpenney.net/multimarkdown/) soltanto, e il pacchetto LaTeX `markdown` al momento non lo supporta.
**Aggiornamento** (aggiunto il 13 maggio 2017): Sulla base di un suggerimento di Vít, è possibile usare la `contentBlocks` estensione di sintassi dalla versione 2.4, oppure ritoccare il `inputFencedCode` renderer, per trasformare rapidamente del testo in stile CSV in una tabella.
### Altre chicche del pacchetto markdown...?
Come accennato prima, è un ottimo modo per prendere appunti e, se combinato con alcune belle classi di documenti LaTeX o configurazioni di pacchetti, ti consente di avere un bellissimo quaderno direttamente alla fine di una lezione. Per esempio, potresti usarlo con le [classi Tufte](https://www.overleaf.com/gallery/tagged/tufte):
```latex
\documentclass{tufte-handout}
\usepackage[footnotes,definitionLists,hashEnumerators,smartEllipses, hybrid]{markdown}
\begin{document}
\markdownInput{PHY303-lecture-12Nov2016.md}
\end{document}
```
E la sintassi breve e semplice che rende molto più comoda la scrittura degli elenchi significa che ora abbiamo un *davvero rapido* modo di scrivere [presentazioni Beamer](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw) e [poster](https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw)!
Divertiti!
---
# 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/30-how-to-write-in-markdown-on-overleaf.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.