Naslaginformatie over Microsoft Q&A Markdown
Microsoft Q&A ondersteunt een uitgebreide webeditor-ervaring, dus u hoeft zich geen zorgen te maken over het bewerken van de inhoud in Markdown. In het geval dat u doet, volgt hier een verwijzing voor het schrijven van Markdown voor Q&A.
Markdown is een lichtgewicht opmaakcodetaal met een syntaxis voor platte tekst.
learn.microsoft.com
(Learn) ondersteunt CommonMark-compatibele Markdown die is geparseerd via de Markdig-parsing-engine . Meer informatie en Q&A bieden ook ondersteuning voor aangepaste Markdown-extensies die uitgebreidere inhoud op de site bieden. Q&A maakt gebruik van een subset van de extensies die worden ondersteund in de documentatie van Learn. Dit artikel bevat een alfabetische verwijzing.
Meer informatie vindt u in het naslagartikel over Learn Markdown.
Codefragmenten
Aanhalingsteken blokkeren
> This example is a blockquote. It's usually rendered indented and with a different background color.
Het voorbeeld hierboven wordt als volgt weergegeven:
Dit is een blokcitaat. Het wordt meestal ingesprongen en met een andere achtergrondkleur weergegeven.
Codeblokken
U kunt de codetaal toevoegen aan een codeblok voor uitgebreidere rendering.
```csharp
public static void Log(string message)
{
_logger.LogInformation(message);
}
```
Het voorbeeld hierboven wordt als volgt weergegeven:
public static void Log(string message)
{
_logger.LogInformation(message);
}
Emoji's
Q&A converteert een emoji-korte code naar de respectieve Unicode-tekens:
This is a test with a :).
Het voorbeeld hierboven wordt als volgt weergegeven:
Dit is een test met een 😃.
Opmaak
Als u tekst als vet wilt opmaken, zet u de tekst tussen dubbele sterretjes:
This text is **bold**.
Als u tekst als cursief wilt opmaken, zet u de tekst tussen enkele sterretjes:
This text is *italic*.
Als u tekst als vet en cursief wilt opmaken, zet u de tekst tussen driedubbele sterretjes:
This text is both ***bold and italic***.
Als u tekst wilt opmaken als doorhalen, plaatst u deze tussen twee om de tekst heen door twee tildes:
This text is ~~strikeout~~.
Kopteksten
Q&A ondersteunt zes niveaus van Markdown-koppen:
# This is a first level heading (H1)
## This is a second level heading (H2)
...
###### This is a sixth level heading (H6)
- Tussen de laatste
#
en de koptekst moet een spatie staan. - Elke vraag, antwoord of opmerking moet één en slechts één H1-kop hebben.
HTML
Als u HTML-inhoud invoert, wordt inhoud niet weergegeven. In plaats daarvan wordt deze weergegeven als tekst zonder opmaak.
Afbeeldingen
De aangepaste :::image:::
Learn-extensie ondersteunt standaardinstallatiekopieën, complexe afbeeldingen en pictogrammen.
:::image source="<folderOrURLPath>" alt-text="<alt text>":::
Waar <alt text>
is een korte beschrijving van de afbeelding en <folderOrURLPath>
is een relatief pad naar de afbeelding of de BIJBEHORENDE URL. Voor schermlezers voor visueel gehandicapten is alternatieve tekst nodig. Dit is ook handig wanneer de afbeelding niet kan worden weergegeven door een sitebug. Kopieer geen bestandsnamen voor gebruik als alternatieve tekst. Dus in plaats van dit:
:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="ADextension_2FA_Configure_Step4":::
Schrijft u dit:
:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="Active Directory extension for two-factor authentication, step 4: Configure":::
Koppelingen
Koppelingen zijn eenvoudig toe te voegen in Q&A. Koppelingen verwijzen gebruikers naar inhoud op een andere pagina in Q&A of een andere vertrouwde bron.
[Link text](<FullURL>).
[Microsoft Q&A products page](/answers/products).`
Tekst van koppeling
De woorden die u in de koppelingstekst opneemt, moeten vriendelijk zijn. Gebruik dus normale beschrijvende tekst of de titel van de pagina die u wilt koppelen.
Gebruik 'hier selecteren' niet voor de koppelingstekst. Het is nadelig voor de zoekmachineoptimalisatie en geeft geen goede beschrijving van het doelobject.
Belangrijk
Alle koppelingen moeten zijn beveiligd (https
vs. http
) wanneer het doel dit ondersteunt (dit zou voor de grote meerderheid moeten gelden).
Voorbeeld:
For more information, see the [Microsoft Q&A products page](/answers/products).
Het bovenstaande voorbeeld wordt weergegeven als:
Zie de microsoft Q&A-productenpagina voor meer informatie.
Automatische koppelingen
Koppelingen worden automatisch opgemaakt voor elke tekenreeks die begint met: , , , , , tel:
of www.
(wordt omgezet in https://www
.) mailto:
ftp://
https://
https://
Lijsten (genummerd, opsommingstekens)
Genummerde lijst
U kunt alle 1's gebruiken om een genummerde lijst te maken. De nummers worden bij het publiceren weergegeven als een sequentiële lijst in oplopende volgorde. Voor een betere leesbaarheid van bronnen kunt u uw lijsten handmatig verhogen.
Gebruik geen letters in lijsten, ook niet in geneste lijsten. Ze worden niet correct weergegeven wanneer ze worden gepubliceerd. Geneste lijsten die gebruikmaken van nummers, worden bij het publiceren weergegeven als kleine letters. Voorbeeld:
1. This is
1. a parent numbered list
1. and this is
1. a nested numbered list
1. (fin)
Dit wordt weergegeven als:
- This is
- een bovenliggende genummerde lijst
- and this is
- a nested numbered list
- (fin)
Lijst met opsommingstekens
Als u een lijst met opsommingstekens wilt maken, gebruikt u -
of *
gevolgd door een spatie aan het begin van elke regel:
- This is
- a parent bulleted list
- and this is
- a nested bulleted list
- All done!
Dit wordt weergegeven als:
- This is
- een bovenliggende lijst met opsommingstekens
- and this is
- a nested bulleted list
- Dat is alles wat u hoeft te doen.
Welke syntaxis u ook gebruikt, -
of *
gebruik deze consistent in uw inhoud.
Tabellen
De eenvoudigste manier om een tabel in Markdown te maken is gebruik te maken van pipes en regels. Als u een standaardtabel met een kop wilt maken, laat u de eerste regel volgen door een stippellijn:
|This is |a simple |table header|
|----------|-----------|------------|
|table |data |here |
|it doesn't|actually |have to line up nicely!|
Dit wordt weergegeven als:
This is | a simple | table header |
---|---|---|
table | gegevens | hier |
it doesn't | actually | have to line up nicely! |