Markdown 展示

VuePress 主要从 Markdown 文件生成页面。因此，你可以使用它轻松生成文档或博客站点。

你应该创建和编写 Markdown 文件，以便 VuePress 可以根据文件结构将它们转换为不同的页面。

Markdown 介绍

如果你是一个新手，还不会编写 Markdown，请先阅读 Markdown 介绍 和 Markdown 演示。

Markdown 配置

VuePress 通过 Frontmatter 为每个 Markdown 页面引入配置。

相关信息

Frontmatter 是 VuePress 中很重要的一个概念，如果你不了解它，你需要阅读 Frontmatter 介绍。

Markdown 扩展

VuePress 会使用 markdown-it 来解析 Markdown 内容，因此可以借助于 markdown-it 插件来实现 语法扩展 。

VuePress 扩展

为了丰富文档写作，VuePress 对 Markdown 语法进行了扩展。

关于这些扩展，请阅读 VuePress 中的 Markdown 扩展。

主题扩展

通过 vuepress-plugin-md-enhance，主题扩展了更多 Markdown 语法，提供更加丰富的写作功能。

自定义容器

安全的在 Markdown 中使用 {{ variable }}。

自定义标题

信息容器，包含 代码 与 链接。

const a = 1;

自定义标题

提示容器

自定义标题

警告容器

自定义标题

危险容器

自定义标题

详情容器

• 查看详情

代码块

pnpm add -D vuepress-theme-hope

yarn add -D vuepress-theme-hope

npm i -D vuepress-theme-hope

• 查看详情

上下角标

19^th H₂O

• 查看详情

自定义对齐

我是居中的

我在右对齐

• 查看详情

Attrs

一个拥有 ID 的 单词。

• 查看详情

脚注

此文字有脚注^[1].

• 查看详情

标记

你可以标记 重要的内容 。

• 查看详情

任务列表

• 计划 1

• 计划 2

• 查看详情

图片增强

支持为图片设置颜色模式和大小

• 查看详情

卡片

title: Mr.Hope
desc: Where there is light, there is hope
logo: https://mister-hope.com/logo.svg
link: https://mister-hope.com
color: rgba(253, 230, 138, 0.15)

• 查看详情

图表

一个散点图案例

• 查看详情

Echarts

一个折线图案例

• 查看详情

流程图

cond=>condition: 是否执行操作?
process=>operation: 操作
e=>end: 结束

cond(yes)->process->e
cond(no)->e

• 查看详情

Mermaid

• 查看详情

Tex 语法

$$\frac{{\partial }^r}{\partial {\omega }^r}\left(\frac{y^{\omega }}{\omega }\right)=\left(\frac{y^{\omega }}{\omega }\right)\{(\log y{)}^r+\sum _{i=1}^r\frac{(-1{)}^{i}r\cdots (r-i+1)(\log y{)}^{r-i}}{{\omega }^i}\}$$

• 查看详情

导入文件

• 查看详情

代码演示

::: normal-demo 一个普通 Demo

<h1>VuePress Theme Hope</h1>
<p><span id="very">非常</span>强大!</p>

document.querySelector("#very").addEventListener("click", () => {
  alert("非常强大");
});

span {
  color: red;
}

:::

• 查看详情

样式化

向 Mr.Hope 捐赠一杯咖啡。 Recommended

• 查看详情

交互演示

::: playground#ts TS 案例

@file index.ts

const msg = "hello world";

const speak = (msg: string) => console.log(msg);

speak(msg);

:::

• 查看详情

Vue 交互演示

::: vue-playground Vue 交互演示

@file App.vue

<script setup>
import { ref } from "vue";

const msg = ref("Hello World!");
</script>

<template>
  <h1>{{ msg }}</h1>
  <input v-model="msg" />
</template>

:::

• 查看详情

幻灯片

• 查看详情

---

1. 这是脚注内容 ↩︎