Microsoft Q&A Markdown-referencia

A Microsoft Q&A támogatja a gazdag webes szerkesztői élményt, így soha nem kell aggódnia a tartalom Markdownban való szerkesztése miatt. Ebben az esetben íme egy hivatkozás a Markdown q&a-hoz való megírásához.

A Markdown egyszerűen kezelhető jelölőnyelv, amely egyszerű szöveg formázására alkalmas szintaxist használ. learn.microsoft.com A (Learn) támogatja a CommonMark-kompatibilis Markdown-elemzést a Markdig-elemzési motoron keresztül. A Learn és a Q&A az egyéni Markdown-bővítményeket is támogatja, amelyek gazdagabb tartalmat biztosítanak a webhelyen. A Q&A a Learn dokumentációjában támogatott bővítmények egy részét használja. Ez a cikk betűrendes hivatkozást tartalmaz.

További információt a Learn Markdown-referenciacikkben talál.

Kódminták

Ajánlat letiltása

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

Az előző példa a következőképpen jelenik meg:

Ez egy idézetblokk. Általában behúzással és más háttérszínnel jelenik meg.

Kódblokkok

A kódnyelvet hozzáadhatja egy kódblokkhoz a részletesebb megjelenítés érdekében.

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

Az előző példa a következőképpen jelenik meg:

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

Hangulatjelek

A Q&A átalakítja az emoji rövid kódját a megfelelő Unicode-karakterekké:

This is a test with a :).

Az előző példa a következőképpen jelenik meg:

Ez egy teszt egy 😃.

Formázás

A félkövérként formázandó szöveget zárja kétszeres csillagjelek közé:

This text is **bold**.

A dőltként formázandó szöveget zárja egyszeres csillagjelek közé:

This text is *italic*.

A félkövérként és dőltként is formázandó szöveget zárja háromszoros csillagjelek közé:

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

Ha a szöveget áthúzásként szeretné formázni, két tildessel körülvéve helyezze el:

This text is ~~strikeout~~.

Fejlécek

A Q&A hat Markdown-címsorszintet támogat:

# This is a first level heading (H1)

## This is a second level heading (H2)

...

###### This is a sixth level heading (H6)

• A legutolsó # szimbólum és a címsor szövege között szóköznek kell szerepelnie.
• Minden kérdésnek, válasznak vagy megjegyzésnek egy és csak egy H1 fejlécet kell tartalmaznia.

HTML

Ha HTML-tartalmat ad meg, a tartalom nem jelenik meg. Ehelyett egyszerű szövegként jelenik meg.

Képek

A Learn egyéni :::image::: bővítménye támogatja a szabványos képeket, az összetett képeket és az ikonokat.

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

Hol <alt text> található a kép rövid leírása, és <folderOrURLPath> hol található a kép vagy URL-címe relatív elérési útja. A helyettesítő szövegek a gyengén látó felhasználók által használt képernyőolvasó programokhoz szükségesek. Ezen kívül hasznosak lehetnek akkor is, ha hiba lép fel az oldal megjelenítésekor, és nem jelennek meg a képek. Ne másolja a helyettesítő szövegként használható fájlneveket. Például a következő szöveg helyett:

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

Írja be az alábbit:

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

Hivatkozások

A hivatkozások könnyen hozzáadhatóak a Q&A-ban. A hivatkozások arra irányítják a felhasználókat, hogy egy másik lapot tartalommal lássak el a Q&A-ban vagy egy másik megbízható forrásban.

[Link text](<FullURL>).

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

Hivatkozás szövege

A hivatkozás szövegében szereplő szavaknak barátságosnak kell lenniük. azaz mindennapos angol szavakat célszerű használni, vagy a hivatkozott oldal címének kell lenniük.

A "Hivatkozás szövege" szöveghez ne használja a "Kijelölés itt" lehetőséget. Ez ugyanis hátrányos a keresőmotor-optimalizálás szempontjából, és nem megfelelően írja le a célt.

Példa:

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

A fenti példa a következőképpen jelenik meg:

További információt a Microsoft Q&A termékek oldalán talál.

Automatikus hivatkozások

A hivatkozások automatikusan lesznek formázva minden olyan sztringhez, amely a következővel kezdődik: , https://, ftp://, , mailto:, tel:vagy www. (feloldja a következőthttps://www: https://.)

Listák (Számozott, Listajeles)

Számozott lista

Számozott lista létrehozásához használhat csupa 1-est. A számok a közzététel után sorszámozott listaként, növekvő sorrendben fognak megjelenni. A forrás olvashatóságának növelése érdekében manuálisan növelheti a listákat.

Ne használjon betűket, még egymásba ágyazott listákban sem. Közzétételkor nem jelennek meg megfelelően. A számokat használó egymásba ágyazott listák közzététel után kisbetűs sorszámozással jelennek meg. Példa:

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

Ez a következőképp jelenik meg:

1. This is
2. számozott szülőlista
   1. and this is
   2. a nested numbered list
3. (fin)

Bulleted list

Listajeles lista létrehozásához az egyes sorok elején használjon - vagy * írásjelet és egy szóközt:

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

Ez a következőképp jelenik meg:

• This is
• listajeles fölérendelt lista
  • and this is
  • a nested bulleted list
• Kész.

Bármelyik szintaxist is használja, - vagy *használja következetesen a tartalomban.

Táblák

A Markdown-szintaxissal táblázat a legegyszerűbben függőleges vonal és kötőjel karakterekkel alakítható ki. Normál fejléccel rendelkező táblázatok létrehozásához az első sor után szúrjon be szaggatott vonalat:

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

Ez a következőképp jelenik meg: