將 Markdown 新增至儀錶板

  • 發行項

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

藉由新增下列資訊，使用 Markdown 小工具支援您的小組和項目關係人：

  • 小組目標。
  • 連結至：
    • 小組待辦專案或面板。
    • 計量。
    • 位於網路共用中的其他專案，例如 OneNote、SharePoint 網站或 Wiki 頁面。
  • 重要日期或目標期限。

以下是範例：
範例 Markdown 小工具的螢幕快照。

必要條件

  • 您必須是 項目的成員。
  • 任何有權存取專案的人，包括 項目關係人，都可以檢視儀表板。
  • 若要新增、編輯或管理小組儀錶板，您必須具有基本存取權、成為小組成員、Project 管理員 istrators 群組的成員，或擁有授與您儀錶板的許可權。 新增至小組管理員角色的小組成員可以管理小組的許可權。
  • 若要新增、編輯或管理專案儀錶板，您必須具有 [基本 ] 存取權，或授 與您選取專案儀錶板的儀錶板許可權 。
  • 若要讓 分析小工具 在儀錶板內運作，您必須 啟用 Analytics。
  • 您必須是 項目的成員。
  • 安裝或啟用 Analytics Marketplace 擴充功能。 如果未安裝、啟用或執行 Analytics，則無法使用分析小工具。
  • 任何有權存取專案的人，包括 項目關係人，都可以檢視儀表板。
  • 若要新增、編輯或管理小組儀錶板，您必須具有基本存取權、小組成員、Project 管理員 istrators 群組的成員，或擁有授與您儀錶板的許可權。 新增至小組管理員角色的小組成員可以管理小組的許可權。
  • 若要讓 分析小工具 在儀錶板內運作，您必須 啟用 Analytics。

注意

圖表或小工具中顯示的數據受限於已登入用戶的許可權。 例如，如果使用者沒有許可權可檢視區域路徑下的工作專案，則這些專案不會顯示在儀錶板中的查詢結果小工具中。 如需詳細資訊，請參閱 Azure DevOps 儀錶板、圖表和報表的常見問題、存取權和許可權。

支援的 Markdown 語法

Markdown 小工具支援 CommonMark 標準功能，例如：

  • 標題
  • 段落和分行符號
  • 引文
  • 水平線
  • 強調 (粗體、斜體、刪除線)
  • 資料表
  • 已排序和未排序的清單
  • 連結
  • 影像
  • 逸出字元

如需使用方式的詳細資訊，請參閱 基本 Markdown 使用量的語法指引。

基於效能考慮，Markdown 小工具不會新增許多擴充功能的支援，其中許多功能在Wiki中受到支援。 擴充功能會妨礙小工具載入時間。 例如，Markdown 小工具不支援下列擴充的 Markdown 功能：

  • 內嵌 HTML 語法
  • 程式代碼醒目提示 （wiki/其他支持語言語法感知色彩編碼，CommonMark 只會將程式代碼轉譯為純格式的文字）
  • 檢查清單
  • Emoji 字元
  • 附件
  • 數學公式

連線 至您的專案

若要將 Markdown 小工具新增至儀錶板，您可以使用支援的網頁瀏覽器連線到您的專案。

開啟網頁瀏覽器、連線至您的專案，然後選取 [ 概觀>儀錶板]。

入口網站的螢幕快照，開啟 [儀錶板]。

如果您需要切換至不同的專案，請選取 Azure DevOps 標誌以 流覽所有專案。

新增 Markdown 小工具

如果您需要新增儀錶板，請參閱 新增、重新命名和刪除儀錶板。

若要將 Markdown 小工具新增至儀錶板，請選取 [編輯]。 小工具目錄會自動開啟。

  1. 將 Markdown 小工具新增或拖曳到您想要找到的儀錶板上。

    Markdown 小工具的螢幕快照。

  2. 選取 [ 完成編輯 ] 以結束儀錶板編輯。 這會關閉小工具目錄。 然後，您可以視需要設定 Markdown 小工具。

  3. 齒輪圖示選取齒輪圖示以開啟小工具的組態對話框。

    若要編輯 Markdown 小工具，您可能需要是小組管理員、Project 管理員 istrators 群組的成員，或獲得許可權。 若要深入瞭解，請參閱 設定儀錶板許可權。

  4. 視需要調整小工具大小，以符合您將輸入的 Markdown 內容。 大小上限為10個磚，寬度為10個磚。 您稍後一律可以調整此內容。

    Markdown 小工具設定對話框的螢幕快照，變更大小。

  5. 在組態對話框中輸入文字和 Markdown 語法。 如需支持的語法，請參閱 Markdown 檔案、小工具、Wiki 和提取要求批注的語法指引。

    我們在這裡顯示一些包含四個連結點符清單的簡單文字

    設定 Markdown、文字項目的螢幕快照。

    提示

    若要連結至Wiki頁面，請使用下列語法：
    /ProjectName/_wiki/wikis/WikiRepositoryName?pagePath=/FileName

    若要連結至專案中的存放庫檔案、頁面或映像，請以 RICH 鍵按下檔案並使用完整的 URL。

    這會轉譯下列小工具：

    入口網站範例 Markdown 小工具的螢幕快照。

    注意

    不支援使用 file:// 之檔案共用上的文件連結。 基於安全性目的，已實作這項限制。

  6. 您可以選擇性地選取以指向存放庫中的檔案。

    使用存放庫檔案設定 Markdown 小工具的螢幕快照。