在 C# 中使用 XML 註解（二）：Visual Studio .NET 產生文件網頁

產生 HTML 文件頁面

Visual Studio .NET 內建工具可將編譯產出的 XML 註解檔 (.xml) 轉換為瀏覽友善的 HTML 頁面：

1. 專案屬性 → 建置 → 勾選 **「XML 文件檔案」** 並指定輸出路徑
2. 建置專案，產出 bin\Debug\ProjectName.xml
3. 選單 **工具 → 產生註解 Web 頁面**
4. 指定 XML 檔案與輸出資料夾，點擊確定

產出畫面範例

生成的 HTML 包含：類別清單、成員詳細說明、參數/回傳值/例外標籤、繼承階層、語法高亮等。

現代替代方案

• DocFX：.NET 社群主流靜態文件產生器，支援 Markdown + XML 註解，輸出響應式網站
• Sandcastle Help File Builder：傳統 CHM/HTML Help 產生器
• Swagger/OpenAPI：Web API 專用，自動從 XML 註解產出互動式文件