Markdown Enhance
VuePress basically generate pages from Markdown files. So you can use it to generate documentation or blog sites easily.
You should create and write Markdown files, so that VuePress can convert them to different pages according to file structure.
Markdown Introduction
If you are a new learner and don’t know how to write Markdown, please read Markdown Intro and Markdown Demo.
Markdown Config
VuePress introduce configuration for each markdown page using Frontmatter.
Info
Frontmatter is a important concept in VuePress. If you don’t know it, you need to read Frontmatter Introduction.
Markdown Extension
The Markdown content in VuePress will be parsed by markdown-it, which supports syntax extensions via markdown-it plugins.
VuePress Enhancement
To enrich document writing, VuePress has extended Markdown syntax.
For these extensions, please read Markdown extensions in VuePress.
Theme Enhancement
By using vuepress-plugin-md-enhance
, the theme extends more Markdown syntax and provides richer writing functions.
Enable all
You can set plugins.mdEnhance.enableAll: true
in theme options to enable all features of the md-enhance plugin.
Custom Container
Safely use {{ variable }} in Markdown.
Custom Title
A custom tip container
Custom Title
A custom warning container
Custom Title
A custom danger container
Custom Title
A custom details container
Code
::: v-pre
Safely use {{ variable }} in Markdown.
:::
::: info Custom Title
A custom information container
:::
::: tip Custom Title
A custom tip container
:::
::: warning Custom Title
A custom warning container
:::
::: danger Custom Title
A custom danger container
:::
::: details Custom Title
A custom details container
:::
Tabs
Code Tabs
Superscript and Subscript
19th H2O
Align
I am center
I am right align
Footnote
This text has footnote[1].
Mark
You can mark important words .
Tasklist
Image Enhancement
Support setting color scheme and size
Chart
Echarts
Flowchart
Mermaid
Tex
Include files
Code Demo
<h1>VuePress Theme Hope</h1>
<p>Is <span id="very">very</span> powerful!</p>
document.querySelector("#very").addEventListener("click", () => {
alert("Very powerful!");
});
span {
color: red;
}
Stylize
Setting this to a invalid stytax doesn't have any effect.
Presentation
This is footnote content ↩︎