Del via

Referanse for Microsoft Q&A Markdown

  • Artikkel

Microsoft Q&A støtter en rik nettredigeringsopplevelse, slik at du slipper å bekymre deg for å redigere innholdet i Markdown. I tilfelle du gjør det, her er en referanse for å skrive Markdown for Q&A.

Markdown er et enkelt kodespråk med en formateringssyntaks i ren tekst. learn.microsoft.com(Learn) støtter CommonMark-kompatibel Markdown analysert gjennom Markdig-analysemotoren. Learn og Q&A støtter også egendefinerte Markdown-utvidelser som gir rikere innhold på nettstedet. Spørsmål og svar bruker et delsett av utvidelsene som støttes i learn-dokumentasjonen. Denne artikkelen inneholder en alfabetisk referanse.

Du kan se mer informasjon i referanseartikkelen Learn Markdown.

Kodesnutter

Blokker tilbud

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

Det foregående eksempelet gjengis som følger:

Dette er en sitatblokk. Det gjengis vanligvis innrykket og med en annen bakgrunnsfarge.

Kodeblokker

Du kan legge til kodespråket i en kodeblokk for rikere gjengivelse.

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

Det foregående eksempelet gjengis som følger:

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

Emojier

Spørsmål og svar konverterer en kort emojikode til de respektive Unicode-tegnene:

This is a test with a :).

Det foregående eksempelet gjengis som følger:

Dette er en test med en 😃.

Formatering

For å formatere tekst som fet, legg ved to stjerner:

This text is **bold**.

For å formatere tekst som kursiv, legg ved en stjerne:

This text is *italic*.

For å formatere tekst som både fet og kursiv, legg ved tre stjerner:

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

Hvis du vil formatere tekst som gjennomstreking, omslutter du den med to omkringliggende med to fliser:

This text is ~~strikeout~~.

Overskrifter

Spørsmål og svar støtter seks nivåer med Markdown-overskrifter:

# This is a first level heading (H1)

## This is a second level heading (H2)

...

###### This is a sixth level heading (H6)
  • Det må være mellomrom mellom den siste # og overskriftsteksten.
  • Hvert spørsmål, svar eller kommentar må ha én og bare én H1-overskrift.

HTML

Hvis du skriver inn HTML-innhold, gjengis ikke innholdet. I stedet vises den som ren tekst.

bilder

Den egendefinerte :::image::: Learn-utvidelsen støtter standardbilder, komplekse bilder og ikoner.

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

Hvor <alt text> er en kort beskrivelse av bildet og <folderOrURLPath> er en relativ bane til bildet eller nettadressen. Alternativ tekst er nødvendig for skjermlesere for brukere med nedsatt syn. Det er også nyttig hvis det finnes en områdefeil hvor bildet ikke kan gjengis. Ikke kopier filnavn for bruk som alternativ tekst. For eksempel, i stedet for dette:

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

Skriv dette:

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

Koblinger er enkle å legge til i Spørsmål og svar. Koblinger peker brukere til innhold på en annen side i Spørsmål og svar eller en annen klarert kilde.

[Link text](<FullURL>).

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

Koble tekst

Ordene du inkluderer i koblingsteksten, bør være egendefinerte. Med andre ord, bør de være normale engelske ord eller tittelen på siden som du kobler til.

Ikke bruk «velg her». For «Koblingstekst». Det er dårlig for optimalisering av søkemotor og beskriver ikke målet tilstrekkelig.

Viktig

Alle koblinger må være sikre (https vs http) når målet støtter det (som de fleste bør).

Eksempel:

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

Eksemplet ovenfor gjengis som:

Hvis du vil ha mer informasjon, kan du se produktsiden for Microsoft Q&A.

Koblinger autoformateres for alle strenger som starter med: https://, , https://, mailto:ftp://, eller tel:www. (løses til https://www.)

Lister (nummerert, punktmerket)

Nummerert liste

Hvis du vil opprette en nummerert liste, kan du bruke alle første. Tallene gjengis i stigende rekkefølge, som en sekvensiell liste når de publiseres. Hvis du vil ha økt lesbarhet for kilder, kan du øke listene manuelt.

Bruk ikke bokstaver i lister, inkludert nestede lister. De gjengis ikke riktig når de publiseres. Nestede lister ved bruk av tall gjengis som små bokstaver når de blir publisert. Eksempel:

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

Dette gjengis som følger:

  1. Dette er
  2. en overordnet nummerert liste
    1. og dette er
    2. en nestet nummerert liste
  3. (fin)

Punktmerket liste

Hvis du vil opprette en punktliste, bruker du -eller * etterfulgt av et mellomrom i begynnelsen av hver linje:

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

Dette gjengis som følger:

  • Dette er
  • en overordnet punktliste
    • og dette er
    • en nestet punktmerket liste
  • Ferdig!

Den syntaksen du bruker, - eller *, bruker den konsekvent i innholdet.

Tabeller

Den enkleste måten å opprette tabeller i Markdown på, er å bruke datakanaler og linjer. Hvis du vil opprette en standardtabell med en overskrift, følger du den første linjen med stiplet linje:

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

Dette gjengis som følger:

Dette er en enkel tabelloverskrift
tabellen data her
det trenger faktisk ikke være finjustert!