Markdown 配置 1.0.0-rc.136 +
约 964 字大约 3 分钟
2025-03-15
概述
Markdown 配置用于控制 Markdown 的行为。此配置聚合了主题为 markdown 增强的各种功能的配置。
.vuepress/config.ts
import { defineUserConfig } from 'vuepress'
import { plumeTheme } from 'vuepress-theme-plume'
export default defineUserConfig({
theme: plumeTheme({
markdown: {
// 在这里配置 markdown
},
}),
})
默认配置:
.vuepress/config.ts
import { defineUserConfig } from 'vuepress'
import { plumeTheme } from 'vuepress-theme-plume'
export default defineUserConfig({
theme: plumeTheme({
markdown: {
hint: true,
alert: true,
fileTree: true,
plot: true,
icons: true,
math: { type: 'katex' },
include: {
// ...option
},
},
}),
})
配置项
hint
和 alter
的功能由 @vuepress/plugin-markdown-hint 插件实现。
hint
- 类型:
boolean
- 默认值:
true
- 详情: 是否启用提示容器
alert
- 类型:
boolean
- 默认值:
true
- 详情: 是否启用 Github 风格的警告语法
image
配置由 @vuepress/plugin-markdown-image 插件实现。
image
- 类型:
boolean | MarkdownImagePluginOptions
- 默认值:
false
- 详情: 是否启用图片增强语法
math
配置由 @vuepress/plugin-markdown-math 插件实现。
math
- 类型:
boolean | MarkdownMathPluginOptions
- 默认值:
{ type: 'katex' }
- 详情: 是否启用数学支持
include
include
配置由 @vuepress/plugin-markdown-include 插件实现。
- 类型:
boolean | MarkdownIncludePluginOptions
- 默认值:
true
- 详情: 是否启用 Markdown 文件导入
以下配置字段由 vuepress-plugin-md-power 插件实现。
annotation
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用内容注释
abbr
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用缩写语法
codeTabs
- 类型:
boolean | CodeTabsOptions
- 默认值:
true
- 详情: 是否启用代码块分组
tabs
- 类型:
boolean | TabsOptions
- 默认值:
true
- 详情: 是否启用 分组
npmTo
- 类型:
boolean | NpmToOptions
- 默认值:
false
- 详情: 是否启用
npm-to
容器
icons
- 类型:
boolean | IconsOptions
- 默认值:
true
- 详情: 是否启用图标语法
plot
- 类型:
boolean | PlotOptions
- 默认值:
true
- 详情: 是否启用隐秘文本语法
fileTree
- 类型:
boolean | FileTreeOptions
- 默认值:
true
- 详情: 是否启用文件树容器语法
timeline
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用时间线容器语法
collapse
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用折叠面板容器语法
chat
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用对话记录容器
demo
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 Demo 容器
- 类型:
boolean | PdfOptions
- 默认值:
false
- 详情: 是否启用 PDF 嵌入语法
bilibili
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 Bilibili 视频嵌入语法
youtube
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 YouTube 视频嵌入语法
artPlayer
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 ArtPlayer 视频嵌入语法
audioReader
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 Audio Reader 音频嵌入语法
codepen
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 CodePen 嵌入语法
codeSandbox
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 CodeSandbox 嵌入语法
jsfiddle
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 JS Fiddle 嵌入语法
repl
- 类型:
boolean | ReplOptions
- 默认值:
false
- 详情: 是否启用 Repl 容器语法
caniuse
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 Can I Use 嵌入语法
imageSize
- 类型:
boolean | 'local' | 'all'
- 默认值:
false
- 详情: 是否启用 自动填充图片宽高属性
以下配置字段由 vuepress-plugin-md-enhance 插件实现。
chartjs
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 Chart.js 图表嵌入语法
echarts
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 ECharts 图表嵌入语法
mermaid
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 Mermaid 图表嵌入语法
markmap
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 Markmap 图表嵌入语法
plantuml
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 PlantUML 图表嵌入语法
flowchart
- 类型:
boolean
- 默认值:
false
- 详情: 是否启用 Flowchart 图表嵌入语法
贡献者
更新日志
2025/4/1 02:23
查看所有更新日志
74dfa
-docs: enable twoslash for code block于62374
-feat(plugin-md-power): addchat
container syntax support (#537)于cca92
-feat(plugin-md-power): addcollapse
syntax support (#535)于5173e
-feat(plugin-md-power): addtimeline
syntax support (#529)于0fd6c
-refactor(theme): improve types and flat config (#524)于