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問答產品頁面。
自動連結
任何開頭為的字串都會自動格式化連結: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! |