閱讀英文

共用方式為


Microsoft Q & A Markdown 參考

Microsoft Q & A 支援豐富的網頁編輯器體驗,因此您永遠不需要擔心在 Markdown 中編輯內容。 在此情況下,以下是撰寫 Q & A Markdown 的參考。

Markdown 是採用純文字格式語法的輕量型標記語言。 learn.microsoft.com (Learn) 支援透過 Markdig 剖析引擎剖析的 CommonMark 相容 Markdown。 Learn 和 Q & A 也支援自訂 Markdown 延伸模組,以提供更豐富的網站內容。 Q & A 使用 Learn 檔所支援的擴充功能子集。 本文提供字母順序參考。

您可以查看 Learn Markdown 參考 文章的詳細資訊

程式碼片段

封鎖引號

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

前述範例會如下呈現:

This is a blockquote. 通常會以不同的背景色彩呈現縮排。

程式碼區塊

您可以將程式碼語言新增至程式碼區塊,以取得更豐富的轉譯。

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

前述範例會如下呈現:

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

Emojis

Q & A 會將 emoji 簡短程式碼轉換成其各自的 Unicode 字元:

This is a test with a :).

前述範例會如下呈現:

這是使用 😃 的測試。

格式化

若要將文字格式設定為粗體,請使用兩個星號將它括住:

This text is **bold**.

若要將文字格式設定為斜體,請使用單一星號將它括住:

This text is *italic*.

若要將文字格式設定為粗體加斜體,請使用三個星號將它括住:

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

若要將文字格式化為 刪除 線,請用兩個波浪線括住它周圍的兩個:

This text is ~~strikeout~~.

標頭

Q & A 支援六個 Markdown 標題層級:

# This is a first level heading (H1)

## This is a second level heading (H2)

...

###### This is a sixth level heading (H6)
  • 最後一個 # 和標題文字之間必須有一個空格。
  • 每個問題、答案或批註都必須有一個且只有一個 H1 標題。

HTML

如果您輸入 HTML 內容,則不會轉譯內容。 相反地,它會顯示為純文字。

圖像

Learn 自訂 :::image::: 延伸模組支援標準影像、複雜影像和圖示。

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

其中 <alt text> 是影像的簡短描述,而 <folderOrURLPath> 是影像或其 URL 的相對路徑。 適用於視障者的螢幕助讀程式需要使用替代文字。 若發生影像無法轉譯的網站錯誤時,替代文字也很實用。 請勿複製檔案名做為替代文字。 例如,不應使用:

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

而是寫成:

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

連結很容易在 Q & A 中新增。 連結會將使用者指向 Q & A 或另一個受信任來源中另一個頁面的內容。

[Link text](<FullURL>).
[Microsoft Q&A products page](/answers/products).`

您在連結文字中包含的文字應該會是易記的。 換句話說,它們應該是簡單的英文單字,或您要連結之網頁的標題。

請勿使用「選取這裡」做為「連結文字」。 這對搜尋引擎最佳化而言並不是一個好的選擇,且沒有適當地描述目標。

重要

只要目標有支援 (絕大部分都會支援) 安全協定,所有連結都必須使用安全協定 (https 相對於 http)。

範例:

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

上述範例會轉譯為:

如需詳細資訊,請參閱 Microsoft Q & A 產品頁面

任何開頭為的字串都會自動格式化連結: https:// 、、 https://ftp://mailto: 、、 tel:www. (解析為 https://www 。)

清單(編號、點符)

編號清單

若要建立編號清單,您可以全部使用 1。 發佈時,數字會以遞增順序轉譯為連續清單。 若要提高來源可讀性,您可以手動增加清單。

請不要在清單中使用字母,包括巢狀清單。 發佈時,它們無法正確呈現。 如果是使用數字的巢狀清單,系統在發佈時會轉譯為小寫字母。 例如:

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

這會轉譯為:

  1. This is
  2. 父編號清單
    1. and this is
    2. a nested numbered list
  3. (fin)

項目符號清單

若要建立項目符號清單,請在每行開頭使用 -* 後接空格:

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

這會轉譯為:

  • This is
  • 父專案符號清單
    • and this is
    • a nested bulleted list
  • 全部完成!

無論您使用哪一種語法,或 *- 在內容中一致地使用它。

資料表

在 Markdown 中建立表格的最簡單做法是使用直立線符號及線條。 若要建立含標題的標準表格,請沿著第一個線段與虛線:

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

這會轉譯為:

This is a simple table header
table 資料 這裡
it doesn't actually have to line up nicely!