# Mintlify 設計規格與首頁分析

語言：繁體中文（台灣用語，zh-TW）。內容整理：2026-10-15。官網參考日期：2026-10-10。

## 參考來源

- 公開來源：https://www.mintlify.com/
- 對應完整預覽：`official-drafts/mintlify.html`
- 預覽 SHA-256：`13fbd9656db4274d733a85445bf0f2a748202461c19fdf104473e990a3da1443`
- 本次更新為文字在地化，不代表重新檢查了今日官網。品牌完整預覽、原始截圖與原生生成紀錄保留來源原貌。

## 目前首頁的視覺與結構

來源：https://www.mintlify.com/。原始取樣時間保留於 UTC 紀錄，oct10 工作檔名不表示所有檢查都在 10 月 10 日完成。

現行首頁改為「智慧文件平台」，使用近黑背景、薄荷綠流線、Arizona Flare 襯線標題與小型白色按鈕。左側主文、Agent traffic 標籤、文件介面圖與右下 Ask assistant 為目前來源；舊的 knowledge infrastructure 主標不可沿用。

完整順序為 20,000+ 公司、六張 knowledge stack／24×7 agents 功能卡、Anthropic／Coinbase／HubSpot／AT&T 企業案例、300M+／2B+／99.99% 當日數字、Lovable／Kalshi／Decagon／Replit、新創與見證、三張最新文章、襯線收尾 CTA 及頁尾。窄版保留側邊露出的輪播卡。

本次重新送交原生 Stitch；提供者草稿加入的辦公室照片與通用示範，不能當官網資產。來源校正改回原始文件／品牌圖與字型。流線與多個卡片實際是 canvas，僅複製 DOM 會丟失可見像素，需有原始像素或明確限定的靜態相位證據。

每個尺寸保留 13 個初始可見 canvas 的實際像素作為靜態影格；水平隱藏的顧客卡 10／11 未曾露出，不能宣稱全部 15 個位置完成。Latest updates 三張則是原始 WebP 圖，不是 canvas；初次瀏覽器已有解碼尺寸但仍未繪出的黑畫面另存診斷，未改 HTML，暖機後重新拍攝才確認圖片正常。

root 已實際查看目前雜湊的桌面 12 段、390px 窄版 15 段及全部 7 張新比較圖。頁高 8457／12555px 與來源相同，兩尺寸各 24 個標題幾何無量測差、無可見壞圖或水平溢位；此為暖機後主要靜態畫面的限定比對。

保留原有 DESIGN.md、PROMPTS.md、STITCH-PROMPT.md；本檔為目前官網的日期限定補充。研究頁免費瀏覽、無付費執行時依賴，未執行購買或訂閱。

驗證範圍為匿名公開首頁、1280×720 與 390×844、DPR 1、桌面 UA。實體手機、其他地區、完整互動與部署尚未驗證；accepted=false，不宣稱與官方一致。

## 套用至自己的專案

製作文件入口，使用穩定的左側導覽、中央文章與精簡頁內目錄。程式碼範例可水平捲動，綠色用於目前位置與有效操作，搜尋支援鍵盤。

可先拆出下列核心元件：文件程式碼範例，包含語言分頁與複製操作。先核對目前預覽的內容層級與構圖，再建立可重複使用的色彩、字型、間距及元件狀態。較早的延伸設計變數位於 `design-md/mintlify/DESIGN.md`；與本次觀察不一致時，以日期限定的實際觀察為準，不把延伸值冒充當日量測。

## 繁體中文與台灣用語

介面文案、按鈕、提示、錯誤訊息、圖片替代文字、設計規格與交付說明，一律使用繁體中文（台灣用語）。保留品牌名稱、字型名稱、檔名、網址、API 識別字與可執行程式碼。HTML 使用 zh-Hant-TW；數字與日期以 zh-TW 格式呈現，幣別及時區依原資料標示，不擅自換算。

使用「專案、元件、資料、建立、預設、載入、登入、連結、儲存、影片、伺服器、滑鼠」等台灣用語。繁體中文可依實際環境採 `Noto Sans TC`、`PingFang TC` 或 `Microsoft JhengHei`，原字型未涵蓋中文字時記錄替代方式。檢查長中文標題與混合中英文換行，不沿用英文固定字寬或大寫字距作為中文限制。

## 響應式與操作要求

以原有尺寸紀錄作視覺對照；新專案另檢查 390px、768px、1440px 的版面。保留語意閱讀順序、可見鍵盤焦點與具名稱的控制項，主要觸控區域建議至少 44px。支援載入、空白、錯誤、停用與已選取狀態，並提供減少動態效果的替代呈現。

以上是新專案的實作建議，不表示原預覽已完成全部互動或無障礙驗收。來源的價格、資料、活動及服務狀態皆屬原日期畫面內容，示範使用時應標明範例，不推論為即時結果。

## 已知差異與限制

- 每種寬度保存 13 個實際初始可見 canvas 點陣階段，索引為 0..9、12..14，並顯示於原始畫布框內。水平客戶卡片隱藏位置 10／11 未觀察到；26 個靜態階段不能證明即時畫布動畫一致。
- 最新消息使用原始 WebP 圖片。初次解碼後尚未繪出的黑畫格，另存為 mintlify-oct11-first-paint-* 診斷資料；目前未改動的 HTML 已在充分載入後完整重拍並檢視實際圖片，冷啟動首次繪製時間仍未驗證。
- 固定畫布波形、桌面品牌與商標旋轉、即時計數器、代理統計及客戶引言階段因時間不同。選單、輪播、助理、表單、Google 登入、分頁與後端尚未驗證，未使用付費帳戶後端。
- 固定的畫布波形階段、桌面品牌與商標旋轉、即時計數器、代理統計及客戶引言尚未同步。
- 隱藏的水平畫布位置 10／11 未觀察到；每種寬度的 13 個實際點陣階段不能證明即時動畫一致。
- 最新消息的原始 WebP 圖片，在充分載入且未重整的完整桌面與窄版截圖中皆完整顯示。早期解碼後未繪出的黑畫格及階段 JSON 另存為首次繪製診斷，不納入目前證據；冷啟動繪製時間仍未驗證。
- 選單、輪播、助理、表單、登入與後端尚未驗證。
- 原始比對未涵蓋其他寬度、實體裝置、地區、完整互動及動態，以及正式部署。

## 交付與驗證

交付實作檔案、設計變數、繁體中文文案、可操作的核心元件與實際檢查結果。逐項列出仍未完成的互動與服務，不以相同頁高、少量幾何資料或供應者宣稱取代完整視覺檢查。原始比對仍為有差異的參考，未宣稱官方授權或完全一致。