Il codice Markdown

Il codice Markdown è un linguaggio di markup molto più leggero e facile da utilizzare rispetto al HTML.

E' stato progettato per formattare il testo in modo semplice e leggibile sia per gli esseri umani che per le macchine.

Ad esempio, Markdown utilizza simboli comuni per applicare formattazioni (es. `*` per il corsivo o `#` per i titoli).

A cosa serve? È molto usato per scrivere documentazione, articoli, README e contenuti web. Ad esempio, è supportato da molte piattaforme, come GitHub, Reddit, e molti editor di testo. Può essere convertito in HTML per essere visualizzato nei browser.

I titoli sono scritti usando il simbolo `#`:

# Titolo di primo livello
## Titolo di secondo livello
### Titolo di terzo livello

Il corsivo  posso realizzarlo usando il simbolo `*` oppure `_` intorno alla parola o alla frase

*Corsivo* o _Corsivo_

Allo stesso modo, posso applicare il grassetto usando il doppio simbolo `**` oppure `__` intorno a una parola o frase

**Grassetto** o __Grassetto__

Il codice Markdown mi permette anche di formattare degli elenchi ovvero delle liste non ordinate usando il simbolo `-` prima di ogni punto.

Ecco un esempio di lista non ordinata

- Elemento 1
- Elemento 2
- Elemento 3

Per realizzare le liste numerate, invece, devo indicare esplicitamente il numero.

1. Primo elemento
2. Secondo elemento
3. Terzo elemento

E' anche possibile inserire un link nel testo usando questa sintassi:

[Testo del link](https://www.andreaminini.it)

La sintassi per visualizzare un'immagine è, invece, la seguente:


Ecco un esempio pratico di testo composto in Markdown.

# Titolo principale
Questo è un **paragrafo in grassetto** e questo è in *corsivo*.
- Punto 1
- Punto 2

Questo codice in Markdown è equivalente al seguente codice scritto in HTML

<h1>Titolo principale</h1>
<p>Questo è un <strong>paragrafo in grassetto</strong> e questo è in <em>corsivo</em>.</p>
<ul>
<li>Punto 1</li>
<li>Punto 2</li>
</ul>

Quali sono i pro e i contro del Markdown?

In generale, il testo Markdown è leggibile anche senza essere formattato e non richiede software complessi per essere utilizzato.

È ideale per formattare un testo in modo rapido senza la complessità di linguaggi più strutturati come l’HTML.

Tuttavia, per essere visualizzato su un browser deve prima essere convertito in HTML, perché i browser non sono in grado di interpretarlo direttamente. E questo è un aspetto negativo da considerare.

Va detto che ci sono diverse piattaforme che convertono automaticamente il Markdown in HTML quando viene caricato un file in .md, come GitHub, GitLab. In questi casi il codice Markdown è sicuramente comodo da usare.

Come convertire un codice Markdown in HTML?

Alcuni editor come Visual Studio Code, Obsidian o Typora possono esportare i file Markdown in HTML.

In alternativa, spesso i linguaggi di programmazione come Python, JavaScript, ecc., offrono librerie per convertire Markdown in HTML

Infine, ci sono molti convertitori online (come Dillinger o Markdown Live Preview) che trasformano un codice Markdown nell'HTML corrispondente. C'è solo l'imbarazzo della scelta.

E così via.