版面

你可以透過設定頁面 frontmatter 的 layout 選項來選擇頁面版面。有 3 種版面選項：doc、page 和 home。如果沒有指定，則頁面會被視為 doc 頁面。

---
layout: doc
---

文件版面

選項 doc 是預設版面，它會將整個 Markdown 內容設定為「文件」樣式。它的運作方式是將整個內容包在 vp-doc css 類別中，並對其下的元素套用樣式。

幾乎所有通用元素（例如 p 或 h2）都會獲得特殊樣式。因此，請記住，如果你在 Markdown 內容中加入任何自訂 HTML，它們也會受到這些樣式的影響。

它還提供以下文件特定功能。這些功能僅在此版面中啟用。

• 編輯連結
• 上一個、下一個連結
• 大綱
• Carbon 廣告

頁面版面

選項 page 被視為「空白頁面」。Markdown 仍會被解析，而且所有 Markdown 擴充功能 的運作方式都與 doc 版面相同，但它不會獲得任何預設樣式。

頁面版面會讓你可以在沒有 VitePress 主題影響標記的情況下，自行設定所有樣式。當你想要建立自己的自訂頁面時，這會很有用。

請注意，即使在此版面中，如果頁面有相符的側邊欄設定，側邊欄仍會顯示。

首頁版面

選項 home 會產生範本化的「首頁」。在此版面中，你可以設定額外的選項，例如 hero 和 features，以進一步自訂內容。請參閱 預設主題：首頁 以取得更多詳細資訊。

沒有版面

如果你不想要任何版面，你可以透過 frontmatter 傳遞 layout: false。如果你想要一個完全自訂的登陸頁面（預設沒有任何側邊欄、導覽列或頁尾），這個選項會很有用。

自訂版面

你也可以使用自訂版面

---
layout: foo
---

這將尋找在 context 中註冊的名為 foo 的組件。例如，您可以在 .vitepress/theme/index.ts 中全局註冊您的組件

import DefaultTheme from 'vitepress/theme'
import Foo from './Foo.vue'

export default {
  extends: DefaultTheme,
  enhanceApp({ app }) {
    app.component('foo', Foo)
  }
}