Microsoft Q&A Markdown-reference
Microsoft Q&A understøtter en omfattende webeditoroplevelse, så du aldrig behøver at bekymre dig om at redigere indholdet i Markdown. Hvis du gør det, er her en reference til at skrive Markdown til Q&A.
Markdown er et let markup language med syntaks til formatering af almindelig tekst.
learn.microsoft.com (Learn) understøtter CommonMark-kompatibel Markdown, der fortolkes via Markdig-fortolkningsprogrammet . Learn og Q&A understøtter også brugerdefinerede Markdown-udvidelser, der giver mere indhold på webstedet. Q&A bruger et undersæt af de udvidelser, der understøttes i Learn's dokumentation. Denne artikel indeholder en alfabetisk reference.
Du kan se flere oplysninger om artiklen Learn Markdown-reference .
Kodestykker
Citatblok
> This example is a blockquote. It's usually rendered indented and with a different background color.
Det foregående eksempel gengiver følgende:
Dette er en citatblok. Den gengives normalt indrykket og med en anden baggrundsfarve.
Kodeblokke
Du kan føje kodesproget til en kodeblok for at få mere detaljeret gengivelse.
```csharp
public static void Log(string message)
{
_logger.LogInformation(message);
}
```
Det foregående eksempel gengiver følgende:
public static void Log(string message)
{
_logger.LogInformation(message);
}
Emojis
Q&A konverterer en kort emoji-kode til de respektive Unicode-tegn:
This is a test with a :).
Det foregående eksempel gengiver følgende:
Dette er en test med en 😃.
Formatering
Hvis du vil formatere tekst som fed, skal du omgive den med to stjerner:
This text is **bold**.
Hvis du vil formatere tekst som kursiv, skal du omgive den med en enkelt stjerne:
This text is *italic*.
Hvis du vil formatere teksten som både fed og kursiv, skal du omgive den med tre stjerner:
This text is both ***bold and italic***.
Hvis du vil formatere tekst som gennemstregning, skal du omslutte den med to omgivende felter:
This text is ~~strikeout~~.
Headere
Spørgsmål og svar understøtter seks niveauer af Markdown-overskrifter:
# This is a first level heading (H1)
## This is a second level heading (H2)
...
###### This is a sixth level heading (H6)
- Der skal være et mellemrum mellem
#og overskriftsteksten. - Hvert spørgsmål, svar eller hver kommentar skal have én og kun én H1-overskrift.
HTML
Hvis du angiver HTML-indhold, gengives indholdet ikke. I stedet vises den som almindelig tekst.
Billeder
Den brugerdefinerede :::image::: Learn-udvidelse understøtter standardbilleder, komplekse billeder og ikoner.
:::image source="<folderOrURLPath>" alt-text="<alt text>":::
Hvor <alt text> er en kort beskrivelse af billedet og <folderOrURLPath> er en relativ sti til billedet eller dets URL-adresse. Der kræves alternativ tekst til skærmlæsere til synshandicappede. Det er også nyttigt, hvis der er en fejl på webstedet, hvor billedet ikke kan gengives. Kopiér ikke filnavne til brug som alternativ tekst. I stedet for dette, f.eks.:
:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="ADextension_2FA_Configure_Step4":::
Skal du skrive dette:
:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="Active Directory extension for two-factor authentication, step 4: Configure":::
Links
Links er nemme at tilføje i Q&A. Links peger brugerne på indhold på en anden side i Q&A eller en anden kilde, der er tillid til.
[Link text](<FullURL>).
[Microsoft Q&A products page](/answers/products).`
Linktekst
De ord, du medtager i linkteksten, skal være brugervenlige. Det skal med andre ord være almindelige engelske ord eller titlen på den side, du opretter et link til.
Brug ikke "vælg her" til "Linktekst". Det er dårligt for optimering af søgemaskiner, og det er ikke en relevant beskrivelse af destinationen.
Vigtigt
Alle links skal være sikre (https vs. http), når destinationssiden understøtter det (hvilket de fleste sider burde gøre).
Eksempel:
For more information, see the [Microsoft Q&A products page](/answers/products).
Ovenstående eksempel gengives som:
Du kan få flere oplysninger på siden Microsoft Q&A-produkter.
Autolinks
Links formateres automatisk for alle strenge, der starter med: https://, https://, ftp://, mailto:, tel:eller www. (fortolkes som https://www.)
Lister (tal og bogstaver, punkttegn)
Nummereret liste
Du kan nøjes med at bruge 1-taller for at oprette en nummereret liste. Tallene gengives i stigende rækkefølge som en fortløbende liste, når den publiceres. Hvis du vil øge kildens læsbarhed, kan du øge dine lister manuelt.
Brug ikke bogstaver i lister, herunder indlejrede lister. De gengives ikke korrekt, når de udgives. På indlejrede lister, hvor der bruger tal, gengives disse som små bogstaver, når listen publiceres. Eksempler:
1. This is
1. a parent numbered list
1. and this is
1. a nested numbered list
1. (fin)
Dette gengives på følgende måde:
- This is
- en overordnet nummereret liste
- and this is
- a nested numbered list
- (fin)
Punktopstilling
Hvis du vil oprette en punktopstilling, skal du bruge - eller *efterfulgt af et mellemrum i begyndelsen af hver linje:
- This is
- a parent bulleted list
- and this is
- a nested bulleted list
- All done!
Dette gengives på følgende måde:
- This is
- en overordnet punktopstilling
- and this is
- a nested bulleted list
- Du er færdig!
Uanset hvilken syntaks du bruger, - eller *, skal du bruge den konsekvent i dit indhold.
Tabeller
Den mest enkle måde at oprette en tabel på i Markdown er at bruge pipetegn og linjer. Hvis du vil oprette en standardtabel med en overskrift, skal den første linje efterfølges af en stiplet linje:
|This is |a simple |table header|
|----------|-----------|------------|
|table |data |here |
|it doesn't|actually |have to line up nicely!|
Dette gengives på følgende måde:
| This is | a simple | table header |
|---|---|---|
| table | data | her |
| it doesn't | actually | have to line up nicely! |