Frontmatter

@vuepress/theme-default

All Pages

Frontmatter in this section will take effect in all types of pages.

externalLinkIcon

  • Type: boolean

  • Details:

    Show navbar on this page or not.

    If you disable navbar in theme config, this frontmatter will not take effect.

  • Also see:

pageClass

  • Type: string

  • Details:

    Add extra class name to this page.

  • Example:

---
pageClass: custom-page-class
---

Then you can customize styles of this page in .vuepress/styles/index.scss file:

.theme-container.custom-page-class {
  /* page styles */
}

Home Page

Frontmatter in this section will only take effect in home pages.

home

  • Type: boolean

  • Details:

    Specify whether the page is homepage or a normal page.

    If you don't set this frontmatter or set it to false, the page would be a normal page.

  • Example:

---
home: true
---

heroImage

  • Type: string

  • Details:

    Specify the url of the hero image.

  • Example:

---
# public file path
heroImage: /images/hero.png
# url
heroImage: https://vuejs.org/images/logo.png
---

heroImageDark

heroAlt

  • Type: string

  • Details:

    Specify the alt attribute of the hero image.

    This will fallback to the heroText.

heroText

  • Type: string | null

  • Details:

    Specify the the hero text.

    This will fallback to the site title.

    Set to null to disable hero text.

tagline

  • Type: string | null

  • Details:

    Specify the the tagline.

    This will fallback to the site description.

    Set to null to disable tagline.

actions

  • Type:
Array<{
  text: string
  link: string
  type?: 'primary' | 'secondary'
}>
  • Details:

    Configuration of the action buttons.

  • Example:

---
actions:
  - text: Get Started
    link: /guide/getting-started.html
    type: primary
  - text: Introduction
    link: /guide/
    type: secondary
---

features

  • Type:
Array<{
  title: string
  details: string
}>
  • Details:

    Configuration of the features list.

  • Example:

---
features:
  - title: Simplicity First
    details: Minimal setup with markdown-centered project structure helps you focus on writing.
  - title: Vue-Powered
    details: Enjoy the dev experience of Vue, use Vue components in markdown, and develop custom themes with Vue.
  - title: Performant
    details: VuePress generates pre-rendered static HTML for each page, and runs as an SPA once a page is loaded.
---
  • Type: string

  • Details:

    Specify the content of the footer.

footerHtml

  • Type: boolean

  • Details:

    Allow HTML in footer or not.

    If you set it to true, the footer will be treated as HTML code.

Normal Page

Frontmatter in this section will only take effect in normal pages.

editLinkPattern

lastUpdated

contributors

sidebarDepth

prev

  • Type: NavLink | string

  • Details:

    Specify the link of the previous page.

    If you don't set this frontmatter, the link will be inferred from the sidebar config.

    To configure the prev link manually, you can set this frontmatter to a NavLink object or a string:

    • A NavLink object should have a text field and a link field.
    • A string should be the path to the target page file. It will be converted to a NavLink object, whose text is the page title, and link is the page route path.
  • Example:

---
# NavLink
prev:
  text: Get Started
  link: /guide/getting-started.html

# NavLink - external url
prev:
  text: GitHub
  link: https://github.com

# string - page file path
prev: /guide/getting-started.md

# string - page file relative path
prev: ../../guide/getting-started.md
---

next

  • Type: NavLink | string

  • Details:

    Specify the link of the next page.

    If you don't set this frontmatter, the link will be inferred from the sidebar config.

    The type is the same as prev frontmatter.