Condividi tramite

Informazioni di riferimento su Markdown di Microsoft Q&

  • Articolo

Microsoft Q&A supporta un'esperienza di editor Web avanzata, quindi non è necessario preoccuparsi di modificare il contenuto in Markdown. Nel caso in cui si fa, ecco un riferimento per la scrittura di Markdown per Q&A.

Markdown è un linguaggio di tipo Lightweight Markup Language (LML) con sintassi di formattazione in testo normale. learn.microsoft.com (Learn) supporta Markdown conforme a CommonMark analizzato tramite il motore di analisi Markdig . Learn e Q&A supportano anche estensioni Markdown personalizzate che forniscono contenuti più avanzati nel sito. Q&A usa un subset delle estensioni supportate nella documentazione di Learn. Questo articolo fornisce un riferimento alfabetico.

Per altre informazioni, vedere l'articolo di riferimento di Learn Markdown.

Frammenti di codice

Blocca virgolette

> This example is a blockquote. It's usually rendered indented and with a different background color.

Ecco il rendering dell'esempio precedente:

This is a blockquote. In genere viene eseguito il rendering di un rientro e con un colore di sfondo diverso.

Blocchi di codice

È possibile aggiungere il linguaggio di codice a un blocco di codice per il rendering più completo.

```csharp
    public static void Log(string message)
            {
                _logger.LogInformation(message);
            }
    ```

Ecco il rendering dell'esempio precedente:

    public static void Log(string message)
            {
                _logger.LogInformation(message);
            }

Emoji

Q&A convertirà un codice breve emoji nei rispettivi caratteri Unicode:

This is a test with a :).

Ecco il rendering dell'esempio precedente:

Si tratta di un test con un oggetto 😃.

Formattazione in corso

Per applicare il formato grassetto al testo, racchiuderlo tra due coppie asterischi:

This text is **bold**.

Per applicare il formato corsivo al testo, racchiuderlo tra due asterischi:

This text is *italic*.

Per applicare il formato grassetto e corsivo al testo, racchiuderlo tra due coppie di tre asterischi:

This text is both ***bold and italic***.

Per formattare il testo come barrato, racchiuderlo tra due tilde:

This text is ~~strikeout~~.

Intestazioni

Q&A supporta sei livelli di intestazioni Markdown:

# This is a first level heading (H1)

## This is a second level heading (H2)

...

###### This is a sixth level heading (H6)
  • Deve essere presente uno spazio tra l'ultimo # e il testo del titolo.
  • Ogni domanda, risposta o commento deve avere una sola intestazione H1.

HTML

Se si immette contenuto HTML, il rendering del contenuto non verrà eseguito. Verrà invece visualizzato come testo normale.

Immagini

L'estensione personalizzata :::image::: Learn supporta immagini standard, immagini complesse e icone.

:::image source="<folderOrURLPath>" alt-text="<alt text>":::

Dove <alt text> è una breve descrizione dell'immagine ed <folderOrURLPath> è un percorso relativo all'immagine o al relativo URL. È necessario testo alternativo per le utilità per la lettura dello schermo destinate a utenti con problemi visivi. È anche utile se, in presenza di un bug nel sito, non è possibile eseguire il rendering dell'immagine. Non copiare i nomi di file da usare come testo alternativo. Ad esempio, invece di scrivere questo:

:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="ADextension_2FA_Configure_Step4":::

Scrivere questo:

:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="Active Directory extension for two-factor authentication, step 4: Configure":::

I collegamenti sono facili da aggiungere in Q&A. I collegamenti indirizzano gli utenti al contenuto di un'altra pagina in Q&A o in un'altra origine attendibile.

[Link text](<FullURL>).

[Microsoft Q&A products page](/answers/products).`

Testo del collegamento

Le parole incluse nel testo del collegamento devono essere descrittive. Devono quindi essere parole normali o il titolo della pagina alla quale porta il collegamento.

Non usare "select here" per "Link text". È una scelta inefficace per l'ottimizzazione dei motori di ricerca e non descrive adeguatamente la destinazione.

Importante

Tutti i collegamenti devono essere protetti (https invece di http) ogni volta che la destinazione lo supporta (come dovrebbe essere nella maggior parte dei casi).

Esempio:

For more information, see the [Microsoft Q&A products page](/answers/products).

Nell'esempio precedente viene eseguito il rendering come segue:

Per altre informazioni, vedere la pagina dei prodotti Microsoft Q&A.

I collegamenti verranno formattati automaticamente per qualsiasi stringa che inizia da: https://, https://, ftp://, mailto:, tel:o www. (viene risolto in https://www.)

Elenchi (numerati, puntati)

Elenco numerato

Per creare un elenco numerato, è possibile usare sempre il numero 1. Al momento della pubblicazione, il rendering dei numeri viene eseguito in ordine crescente, come elenco sequenziale. Per migliorare la leggibilità dell'origine, è possibile aumentare manualmente gli elenchi.

Non usare lettere negli elenchi, neppure in quelli annidati, Il rendering non viene eseguito correttamente quando viene pubblicato. Gli elenchi annidati che usano i numeri vengono visualizzati con lettere minuscole quando vengono pubblicati. Ad esempio:

1. This is
1. a parent numbered list
   1. and this is
   1. a nested numbered list
1. (fin)

Il rendering è il seguente:

  1. This is
  2. elenco numerato padre
    1. and this is
    2. a nested numbered list
  3. (fin)

Elenco puntato

Per creare un elenco puntato, usare - o * seguito da uno spazio all'inizio di ogni riga:

- This is
- a parent bulleted list
  - and this is
  - a nested bulleted list
- All done!

Il rendering è il seguente:

  • This is
  • elenco puntato padre
    • and this is
    • a nested bulleted list
  • Ecco fatto!

Indipendentemente dalla sintassi usata o -*, usarla in modo coerente nel contenuto.

Tabelle

Il metodo più semplice per creare una tabella in Markdown consiste nell'uso di barre verticali e linee. Per creare una tabella standard con un titolo, la prima linea deve essere seguita da una linea tratteggiata:

|This is   |a simple   |table header|
|----------|-----------|------------|
|table     |data       |here        |
|it doesn't|actually   |have to line up nicely!|

Il rendering è il seguente:

This is a simple table header
table data qui
it doesn't actually have to line up nicely!