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);
}
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 內容,則不會轉譯內容。 相反地,它會顯示為純文字。
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! |