2026-03-08 21:55:27 +08:00

2.8 KiB
Raw Permalink Blame History

title, icon, createTime, permalink, tags
title icon createTime permalink tags
扩展 fluent-mdl2:auto-enhance-on 2024/03/05 23:29:07 /guide/markdown/extensions/
指南
markdown

标题锚点

标题会自动应用锚点。

自定义锚点

要为标题指定自定义锚点而不是使用自动生成的锚点,请向标题添加后缀:

# 使用自定义锚点 {#my-anchor}

这允许将标题链接为 #my-anchor,而不是默认的 #使用自定义锚点

链接

内部和外部链接都会被特殊处理。

主题默认对每个 Markdown 文件自动生成一个新的链接,并保存在对应的 Markdown 文件的 frontmatter 的 permalink 中。您可以随时修改它们。您也可以通过 theme.autoFrontmatter 选项来禁用这个功能,这时会恢复为 VuePress 的默认行为。

内部链接

有三种方式来使用内部链接:

  • 使用生成的 permalink 作为内部链接的目标。
  • 使用 Markdown 文件的相对路径作为内部链接的目标。
  • 使用 Markdown 文件的绝对路径作为内部链接的目标,绝对路径 / 表示从 ${sourceDir} 目录开始。
[Markdown](/guide/markdown/)

[Markdown](./basic.md)

渲染为:

Markdown

Markdown

外部链接

外部链接带有 target="_blank" rel="noreferrer"

VuePress

Github风格的表格

输入:

| Tables        |      Are      |  Cool |
| ------------- | :-----------: | ----: |
| col 3 is      | right-aligned | $1600 |
| col 2 is      |   centered    |   $12 |
| zebra stripes |   are neat    |    $1 |

输出:

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

目录表

输入:

[[TOC]]

输出:

TOC

上下角标

  • 使用 ^ ^ 进行上角标标注。
  • 使用 ~ ~ 进行下角标标注。

输入:

- 19^th^
- H~2~O

输出:

  • 19^th^
  • H2O

自定义对齐

输入:

::: left
左对齐的内容
:::

::: center
居中的内容
:::

::: right
右对齐的内容
:::

输出:

::: left 左对齐的内容 :::

::: center 居中的内容 :::

::: right 右对齐的内容 :::

任务列表

输入:

- [ ] 任务 1
- [x] 任务 2
- [ ] 任务 3

输出:

  • 任务 1
  • 任务 2
  • 任务 3

脚注

输入:

人生自古谁无死,留取丹心照汗青[^脚注1]。

[^脚注1]: 出自 宋·文天祥 **《过零丁洋》**

输出:

人生自古谁无死,留取丹心照汗青1


  1. 出自 宋·文天祥 《过零丁洋》 ↩︎