Front Matter 配置

title

  • Type: string

页面的标题。默认情况下,页面的 h1 标题将用作 HTML 文档的标题。但是如果你想使用不同的标题,你可以使用 Front Matter 来指定页面的标题。例如:

md
---
title: 我的主页
---

description

  • Type: string

页面的自定义描述。例如:

md
---
description: 这是我的主页
---

pageType

  • Type: 'home' | 'doc' | 'api' | 'custom' | '404'
  • Default: 'doc'

页面的类型。默认情况下,页面类型为doc。但是如果你想使用不同的页面类型,你可以使用pageType指定页面类型。

layout

  • Type: string
  • Default: undefined

渲染页面时使用的布局。

api

  • Type: boolean
  • Default: false

表示当前页为 api 页面。相当于pageType: 'api'

md
---
api: true
---

hero

  • Type: Object

home 页面的 hero 配置。它有以下类型:

ts
export interface Hero {
  name: string;
  text: string;
  tagline: string;
  image?: {
    src: string;
    alt: string;
  };
  actions: {
    text: string;
    link: string;
    theme: 'brand' | 'alt';
  }[];
}

features

  • Type: Array
  • Default: []

home 页面的功能配置。它有以下类型:

ts
export interface Feature {
  title: string;
  details: string;
  icon: string;
}
  • Type: boolean
  • Default: true

是否在页面上显示左侧边栏。设置为 false 可以隐藏它。

outline

  • Type: boolean
  • Default: true

是否在页面上显示右侧大纲。设置为 false 可以隐藏它。

lineNumbers

  • Type: boolean
  • Default: false

是否在当前页面的代码块中显示行号。

sponsors

  • Type: Sponsor[]
  • Default: []

页面的赞助商列表。

ts
export interface Sponsor {
  name: string;
  logo: string;
  link: string;
}

cta

  • Type: Object

号召性用语配置。

ts
export interface CTA {
  title: string;
  text?: string;
  link?: string;
  buttonText?: string;
}