Migliorare i testi con Markdown

Markdown consente di migliorare la gestione del formato testo disponibile in Moodle consentendo di inserire in modo semplice formattazioni (grassetto, corsivo), strutture (elenchi, intestazioni) e link (a immagini o altre risorse web). E' possibile usare Markdown in diversi punti di Moodle, selezionandolo dal menu a tendina Formato presente sotto all'area di inserimento del testo della risorsa.

Concetti base

Per inserire il testo basta semplicemente digitarlo nell'area di inserimento del testo, premendo due volte il tasto INVIO alla fine del paragrafo per lasciare una linea bianca tra un paragrafo e il successivo.

Stile del testo

Con Markdown possono essere inseriti tre tipi di stili del testo, il corsivo, il grassetto e il grassetto e corsivo. I diversi stili si ottengono, circondando il testo da enfatizzare con asterischi, nel modo seguente:

*corsivo* -> corsivo
**grassetto** -> grassetto
***grassetto corsivo*** -> grassetto corsivo

Lo stile può essere attribuito a singole parole, frasi o parti di una parola:

una *singola* parola -> una singola parola
***una intera frase*** -> una intera frase
in**distingui**bile -> indistinguibile

Il trattino di sottolineatura (_) può essere utilizzato al posto degli asterischi.

Intestazioni

Markdown permette di strutturare il testo attraverso la definizione di sei diversi livelli di intestazioni (generalmente se ne usano al massimo tre in un normale testo, come il presente help).

Le intestazioni si creano iniziando la riga di testo con uno o più caratteri 'cancelletto' (#). Un 'cancelletto' è l'intestazione più importante, di più alto livello, sei 'cancelletti' rappresentano quella di più basso livello.

# intestazione di sezione
## intestazione di sotto-sezione
### intestazione di sotto-sotto-sezione
ecc.

I primi due livelli di intestazione sono i più comuni e possono essere creati in modi alternativi per farli risaltare maggiormente nella versione testuale (l'output sarà comunque uguale). Questa alternativa usa una linea di 'uguali' (=) o di trattini (-) posizionate sotto il titolo:

Intestazione di sezione
=======================

Intestazione di sotto-sezione
-----------------------------

Elenchi

Elenchi puntati

Gli elenchi puntati possono essere creati iniziando ogni riga con un asterisco seguito da uno spazio (* ) prima del contenuto. Lo spazio dopo l'asterisco è importante e non puà essere omesso.

* primo punto
* secondo punto
* terzo punto

diventa

  • primo punto
  • secondo punto
  • terzo punto

Elenchi numerati

Allo stesso modo, gli elenchi puntati sono creati iniziando ogni riga con un numero seguito da uno spazio.

1. primo punto
2. secondo punto
3. terzo punto

diventa

  1. primo punto
  2. secondo punto
  3. terzo punto

Elenchi nidificati

E' possibile creare elenchi nidificati, utilizzando anche nella stessa struttura, punti elenco e numeri:

    * Primo punto di primo livello
      * primo punto di secondo livello  
      * secondo punto di secondo livello 
    * Secondo punto di primo livello  
    1. Primo punto numerato
       1. Punto numerato di secondo livello  
    2. Secondo punto numerato

diventa

  • Primo punto di primo livello
    • primo punto di secondo livello
    • secondo punto di secondo livello
  • Secondo punto di primo livello
    1. Primo punto numerato
      1. Punto numerato di secondo livello
    2. Secondo punto numerato

Paragrafi virgolettati

Una sezione del testo può essere marcata come 'citazione' o 'testo virgolettato' iniziando la riga con il segno di 'maggiore' (>), lo stesso carattere utilizzato nella maggior parte dei programmi per la gestione di email per indicare la citazione del testo del mittente. L'output generalmente si presenta con testo rientrato da entrambi i margini.

> Questa è una citazione
> divisa su due righe

diventa

Questa è una citazione
divisa su due righe

E' anche possibile usare un solo > all'inizio della prima riga del paragrafo

> Solo la prima riga di questo
paragrafo inizia con > anche se
la citazione è su più righe

diventa

Solo la prima riga di questo
paragrafo inizia con > anche se
la citazione è su più righe

Web Link

Ci sono due modi per creare link a risorse web: il primo consiste nell'includere il link nel testo, posizionando il testo linkato tra parentesi quadre, e l'URL corrispondente immediatamente dopo, tra parentesi tonde, senza spazi tra i due elementi tra parentesi. E' possibile inserire anche un titolo per il link, tra doppi apici dopo l'URL).

Un [link esempio](http://example.com/ "Titolo opzionale") in una frase.

diventa

Un link esempio in una frase.

Il titolo, se inserito, sarà visualizzato come 'tooltip' quando l'utente posizionerà il puntatore del mouse, prima di cliccare.

Per link più lunghi è possibile evitare di alterare il flusso del testo e inserirli come nota a pié di pagina. In questo caso si inserisce un identificativo, subito dopo il primo elemento tra parentesi quadre.

Un [link esempio][ex] in una frase.

A questo punto si può definire l'URL associata in qualsiasi punto nel documento, ma preferibilmente dopo il paragrafo contenente il link oppure tutti insieme alla fine del documento, come una bibliografia:

[ex]: http://example.com/ "Titolo opzionale"

Il risultato finale del secondo esempio è identico al primo. E' solo un modo per organizzare i link all'interno del documento in modo più ordinato.

Una ulteriore modalità, più rapida, nel caso l'URL coincida con il testo da linkare, consiste nell'inserire direttamente l'URL tra parentesi angolari (< >):

<http://moodle.org/>

che diventa

http://moodle.org

Immagini

Le immagini si inseriscono in modo molto simile ai web link, ma sono precedute dal punto esclamativo (!). Il testo alternativo (ovvero il tag 'alt') viene visualizzato per gli utenti che non sono in grado di vedere le immagini per svariate ragioni. Questo permette anche di avere un memo sul significato dell'immagine per coloro che editano il testo.

Il titolo è visualizzato in una piccola finestra popup quando l'utente posizionerà il puntatore del mouse sull'immagine, dando modo di fornire ulteriori informazioni.

![testo alt](/path/img.jpg "Titolo opzionale")

Come per i web link, è possibile utilizzare gli identificativi per organizzare le URL delle immagini come note a pié di pagina:

![testo alt][foto1]

In qualsiasi punto del documento, si associa l'identificativo con l'URL dell'immagine:

[foto1]: /url/to/img.jpg "Titolo opzionale"

Un esempio seguito dalla visualizzazione reale:

![Il logo di Google](http://www.google.com/images/logo.gif "Il logo di Google")

Il logo di Google

Il testo 'alt', che è importante anche per ragioni di accessibilità, è spesso usato dai browser quando i link alle immagini non sono validi o temporaneamente non disponibili:

![testo alternativo per immagine non disponibile](http://example.com/immagine_non_esistente "Questa immagine non si visualizza ")

diventa:

testo alternativo per immagine non disponibile

Funzioni avanzate

Questa breve introduzione ha illustrato le principali funzioni di Markdown, utilizzate nella maggior parte dei casi. E' possibile ottenere risultati molto più complessi, in particolare se si ha una conoscenza di HTML, ma queste funzioni sono spiegate in un documento separato sull'Uso avanzato di Markdown.

Maggiori informazioni sull'uso avanzato di Markdown

Indice di tutti i file di aiuto