Microsoft Q&A Markdown – referenční dokumentace

Microsoft Q&A podporuje bohaté prostředí webového editoru, takže byste se nikdy nemuseli starat o úpravy obsahu v Markdownu. V případě, že to uděláte, tady je odkaz pro psaní Markdownu pro Q&A.

Markdown je jednoduchý jazyk využívající značky se syntaxí formátování prostého textu. learn.microsoft.com (Learn) podporuje markdown kompatibilní se standardem CommonMark, který se parsuje prostřednictvím modulu pro analýzu Markdigu . Learn a Q&A také podporují vlastní rozšíření Markdownu, která poskytují bohatší obsah na webu. Q&A používá podmnožinu rozšíření podporovaných v dokumentaci learn. Tento článek obsahuje abecední odkaz.

Další informace najdete v referenčním článku o markdownu Learn.

Fragmenty kódu

Bloková citace

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

Předchozí příklad se zobrazí takto:

This is a blockquote. Obvykle se odsadí a má jinou barvu pozadí.

Bloky kódu

Jazyk kódu můžete přidat do bloku kódu pro rozsáhlejší vykreslování.

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

Předchozí příklad se zobrazí takto:

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

Emoji

Q&A převede krátký kód emoji na příslušné znaky Unicode:

This is a test with a :).

Předchozí příklad se zobrazí takto:

Toto je test s 😃.

Formát

Pokud chcete text naformátovat jako tučný, použijte dvě hvězdičky z obou stran:

This text is **bold**.

Pokud chcete text naformátovat jako kurzívu, použijte jednu hvězdičku z obou stran:

This text is *italic*.

Pokud chcete text naformátovat jako tučný i kurzívu, použijte tři hvězdičky z obou stran:

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

Pokud chcete text naformátovat jako přeškrtnutou, uzavřete ho do dvou okolních vlnovek:

This text is ~~strikeout~~.

Hlavičky

Q&A podporuje šest úrovní nadpisů Markdownu:

# This is a first level heading (H1)

## This is a second level heading (H2)

...

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

• Mezi posledním symbolem # a textem nadpisu musí být mezera.
• Každá otázka, odpověď nebo komentář musí mít jeden a jenom jeden nadpis H1.

HTML

Pokud zadáte obsah HTML, nebude se obsah vykreslovat. Místo toho se zobrazí jako prostý text.

Obrázky

Vlastní :::image::: rozšíření Learn podporuje standardní obrázky, složité obrázky a ikony.

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

Kde <alt text> je stručný popis obrázku a <folderOrURLPath> je relativní cestou k obrázku nebo jeho adrese URL. Alternativní text se vyžaduje pro čtečky obrazovky, které používají lidé s vadami zraku. Je rovněž užitečný, pokud je na webu chyba a obrázek se nezobrazí. Nekopírujte názvy souborů pro použití jako alternativní text. Například namísto tohoto:

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

Napište toto:

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

Odkazy

Odkazy se dají snadno přidat v Q&A. Odkazy odkazují uživatele na obsah jiné stránky v Q&A nebo jiném důvěryhodném zdroji.

[Link text](<FullURL>).

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

Text odkazu

Slova, která do textu odkazu zahrnete, by měla být popisná. Jinými slovy by mělo jít o normální slova nebo název stránky, na kterou odkazujete.

Nepoužívejte možnost "vybrat sem". Pro text odkazu. Je to špatné pro optimalizaci vyhledávacího webu a adekvátně to nepopisuje cílovou stránku.

Důležité

Všechny odkazy musí být zabezpečené (https versus http), když to cíl podporuje (což by měla drtivá většina).

Příklad:

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

Výše uvedený příklad se vykreslí takto:

Další informace najdete na stránce produktů Microsoft Q&A.

Automatické odkazy

Propojení budou automaticky formátována pro libovolný řetězec začínající na: , , , , , tel:nebo www. (překládá na https://www.) mailto:ftp://https://https://

Seznamy (číslovaný, odrážkový)

Číslovaný seznam

Při vytváření číslovaného seznamu můžete všude použít jedničky (1). Ty se při publikování zobrazí jako sekvenční seznam ve vzestupném pořadí. Pokud chcete zvýšit čitelnost zdroje, můžete seznamy zvýšit ručně.

Nepoužívejte v seznamech ani vnořených seznamech písmena. Při publikování se nevykreslují správně. Vnořené seznamy používající čísla se při publikování zobrazí jako malá písmena. Příklad:

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

Toto se zobrazí takto:

1. This is
2. nadřazený číslovaný seznam
   1. and this is
   2. a nested numbered list
3. (fin)

Seznam s odrážkami

Pokud chcete vytvořit seznam s odrážkami, použijte na začátku každého řádku znak - nebo * následovaný mezerou:

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

Toto se zobrazí takto:

• This is
• nadřazený seznam s odrážkami
  • and this is
  • a nested bulleted list
• Hotovo!

Ať už používáte jakoukoli syntaxi, - nebo *ji v obsahu konzistentně používejte.

Tabulky

Nejjednodušším způsobem, jak v Markdownu vytvořit tabulku, je použít svislé čáry a řádky. Pokud chcete vytvořit standardní tabulku se záhlavím, za první řádek vložte čárkovaný řádek:

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

Toto se zobrazí takto:

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