Dela via

Microsoft Q&A Markdown-referens

  • Artikel

Microsoft Q&A har stöd för en omfattande webbredigerare, så du behöver aldrig bekymra dig om att redigera innehållet i Markdown. I det fall du gör det här är en referens för att skriva Markdown för Q&A.

Markdown är ett förenklat märkspråk med syntax för oformaterad textformatering. learn.microsoft.com (Learn) stöder CommonMark-kompatibel Markdown som parsas via Markdig-parsningsmotorn . Learn och Q&A har även stöd för anpassade Markdown-tillägg som ger bättre innehåll på webbplatsen. Q&A använder en delmängd av tilläggen som stöds i Learns dokumentation. Den här artikeln innehåller en alfabetisk referens.

Mer information finns i referensartikeln Learn Markdown.

Kodfragment

Blockera offert

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

Föregående exempel återges enligt följande:

Det här är ett blockcitat. Det återges vanligtvis indrag och med en annan bakgrundsfärg.

Kodblock

Du kan lägga till kodspråket i ett kodblock för mer omfattande återgivning.

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

Föregående exempel återges enligt följande:

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

Emojis

Q&A konverterar en kort emojikod till respektive Unicode-tecken:

This is a test with a :).

Föregående exempel återges enligt följande:

Det här är ett test med .😃

Formatera

Använd två asterisker runt textsträngen för att formatera text som fetstil:

This text is **bold**.

Använd en asterisk runt textsträngen för att formatera text som kursiv:

This text is *italic*.

Använd tre asterisker runt textsträngen för att formatera text som både fet och kursiv:

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

Om du vill formatera text som strikeout omger du den med två omger den med två tildes:

This text is ~~strikeout~~.

Sidhuvuden

Q&A stöder sex nivåer av Markdown-rubriker:

# This is a first level heading (H1)

## This is a second level heading (H2)

...

###### This is a sixth level heading (H6)
  • Det måste finnas ett blanksteg mellan den sista # och rubriktexten.
  • Varje fråga, svar eller kommentar måste ha en och endast en H1-rubrik.

HTML

Om du anger HTML-innehåll återges inte innehåll. I stället visas den som oformaterad text.

Bilder

Det anpassade :::image::: tillägget Learn stöder standardbilder, komplexa bilder och ikoner.

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

Var <alt text> är en kort beskrivning av bilden och <folderOrURLPath> är en relativ sökväg till bilden eller dess URL. Alternativ text krävs för skärmläsare för personer med nedsatt syn. Det är också användbart om det uppstått ett fel på webbplatsen och bilden inte kan återges. Kopiera inte filnamn för användning som alternativtext. I stället för detta:

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

Kan du skriva följande:

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

Länkar är enkla att lägga till i Q&A. Länkar pekar användare till innehåll på en annan sida i Q&A eller någon annan betrodd källa.

[Link text](<FullURL>).

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

Länktext

De ord som du tar med i länktexten ska vara egna. De ska med andra ord vara vanliga ord eller rubriken på sidan som du länkar till.

Använd inte "välj här" för "Länktext". Det fungerar dåligt vid sökmotoroptimering och beskriver inte målet på rätt sätt.

Viktigt!

Alla länkar måste vara säkra (https mot http) när målet har stöd för den (vilket de flesta bör ha).

Exempel:

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

Exemplet ovan återges som:

Mer information finns på sidan microsofts Q&A-produkter.

Länkarna formateras automatiskt för alla strängar som börjar med: , , , , , tel:eller www. (matchas till https://www.) mailto:ftp://https://https://

Listor (numrerade, punktlistor)

Numrerad lista

Om du vill skapa en numrerad lista kan du använda 1 för samtliga objekt. Numren återges i stigande ordning som en sekventiell lista när de publiceras. För ökad läsbarhet för källor kan du öka dina listor manuellt.

Använd inte bokstäver i listor, inte heller i kapslade listor. De återges inte korrekt när de publiceras. Om listor kapslas med siffror renderas de som gemener när listorna publiceras. Till exempel:

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

Detta renderas så här:

  1. This is
  2. en överordnad numrerad lista
    1. and this is
    2. a nested numbered list
  3. (fin)

Punktlista

Om du vill skapa en punktlista använder du - eller * följt av ett blanksteg i början av varje rad:

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

Detta renderas så här:

  • This is
  • en överordnad punktlista
    • and this is
    • a nested bulleted list
  • Klart!

Oavsett vilken syntax du använder, - eller *, använder du den konsekvent i ditt innehåll.

Tabeller

Det enklaste sättet att skapa en tabell i Markdown är att använda lodräta streck och linjer. Om du vill skapa en standardtabell med en rubrik anger du en streckad linje efter första raden:

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

Detta renderas så här:

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