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)
這會轉譯為：
- This is
- 父編號清單
- and this is
- a nested numbered list
- (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! |