Markdown 语法配置

The following options adds new markdown grammar, and can be set under markdown property in theme options.

以下选项在 markdown 中添加了新的语法，可以在主题选项的 markdown 属性下进行设置。

markdown.component

• 类型: boolean
• 默认值: false
• 详情:
  • 组件 → 语法
  • @vuepress/plugin-markdown-ext → component

是否启用组件支持。

markdown.footnote

• 类型: boolean
• 默认值: false
• 在 GFM 中启用: 是
• 详情:
  • Markdown → 脚注
  • @vuepress/plugin-markdown-ext → footnote

是否启用脚注格式支持。

markdown.imgMark

• 类型: boolean
• 默认值: false
• 详情:
  • Markdown → 图片标记
  • @vuepress/plugin-markdown-image → mark

是否启用图片标记。

markdown.imgSize

• 类型: boolean
• 默认值: false
• 详情:
  • Markdown → 图片大小
  • @vuepress/plugin-markdown-image → size

是否启用图片大小。

markdown.obsidianImgSize

• 类型: boolean
• 默认值: false
• 详情:
  • Markdown → 图片大小
  • @vuepress/plugin-markdown-image → obsidianSize

是否启用 Obsidian 图片大小。

markdown.include

• 类型: MarkdownIncludePluginOptions | boolean

  interface MarkdownIncludePluginOptions {
    /**
     * 处理包含的文件路径
     *
     * @default (path) => path
     */
    resolvePath?: (path: string, cwd: string) => string;
  
    /**
     * 是否在包含的 Markdown 文件中深度包含文件
     *
     * @default false
     */
    deep?: boolean;
  }

• 默认值: false

• 详情:

  • Markdown → 导入文件
  • @vuepress/plugin-markdown-include

是否启用 Markdown 导入支持。您可以传递一个选项来自定义行为。

markdown.tabs

• 类型: boolean
• 默认值: false
• 详情:
  • Markdown → 选项卡
  • @vuepress/plugin-markdown-tab → tabs

是否启用选项卡支持。

markdown.tasklist

• 类型: MarkdownItTaskListOptions | boolean

  interface MarkdownItTaskListOptions {
    /**
     * 是否禁用复选框
     *
     * @default true
     */
    disabled?: boolean;
  
    /**
     * 是否使用 `<label>` 包装文本
     *
     * @default true
     */
    label?: boolean;
  }

• 默认值: false

• 在 GFM 中启用: 是

• 详情:

  • Markdown → 任务列表
  • @vuepress/plugin-markdown-ext → tasklist

是否启用任务列表格式支持。你可以传递一个对象来配置任务列表。

markdown.math

• 类型: MarkdownMathPluginOptions | boolean

  interface MarkdownKatexPluginOptions
    extends Omit<MarkdownItKatexOptions, "transformer"> {
    type?: "katex";
    /**
     * 是否启用复制插件
     *
     * @default false
     */
    copy?: boolean;
  }
  
  interface MarkdownMathjaxPluginOptions
    extends Omit<MarkdownItMathjaxOptions, "transformer"> {
    type?: "mathjax";
  }
  
  type MarkdownMathPluginOptions =
    | MarkdownKatexPluginOptions
    | MarkdownMathjaxPluginOptions;

• 默认值: false

• 详情:

  • Markdown → 数学公式
  • @vuepress/plugin-markdown-math

是否启用数学公式支持。你可以设置 true 来自动检测已安装的 katex/mathjax，或提供插件选项。

markdown.revealjs

• 类型: RevealJsOptions | boolean

  interface RevealJsOptions {
    /**
     * 幻灯片插件
     *
     * @default []
     */
    plugins?: RevealJsPlugin[];
    /**
     * 幻灯片主题
     *
     * @default ["auto"]
     */
    themes?: RevealJsTheme[];
  }

• 默认值: false

• 详情:

  • Markdown → 幻灯片
  • @vuepress/plugin-revealjs

控制 @vuepress/plugin-revealjs，提供幻灯片支持。你可以设置 true 来直接启用它，或提供插件选项。