在寫文建站頁面裡閱讀文件

文件檢視器讓讀者在文章或頁面裡閱讀 Word、PDF、PowerPoint 和 Excel。我把原始文件放進 content/assets/documents/，再引用它的站內路徑。預覽在原處展開，不移動鍵盤焦點；標題由文件元素顯示一次。

文章在 Markdown 內文裡單獨放一行。下面的路徑需要換成你已經加入的檔案：

!document[專案報告](/documents/project-report.pdf)

JSON 頁面則把文件元素放進某個儲存格的元素陣列：

{
  "type": "document",
  "title": "專案報告",
  "src": "/documents/project-report.pdf"
}

預覽用連續閱讀區域展示分開的頁面，試算表保留工作表切換。周圍控制項跟隨網站配色，文件內容保留自身顏色。不同格式的解析成本不同，我會檢查實際樣本，不把所有檔案都當成能持續串流讀取、保持固定記憶體的內容。

文字版暫緩載入檢視器，讀者需要時再請求。遠端檔案直連需要目前有效的服務同意，來源還須允許 CORS；同意服務不會自動下載全部文件或元件。建置後在本機檢查捲動、鍵盤焦點、手機寬度，以及完整版與文字版之間的切換。

我提问