diff --git a/docs/.vuepress/collections/en/theme-guide.ts b/docs/.vuepress/collections/en/theme-guide.ts
index 4a323709..26e945ac 100644
--- a/docs/.vuepress/collections/en/theme-guide.ts
+++ b/docs/.vuepress/collections/en/theme-guide.ts
@@ -41,12 +41,17 @@ export const themeGuide: ThemeCollectionItem = defineCollection({
items: [
'basic',
'extensions',
+ 'attrs',
+ 'emoji',
+ 'math',
'table',
'icons',
'mark',
'plot',
'abbr',
'annotation',
+ 'container',
+ 'github-alerts',
'card',
'steps',
'file-tree',
@@ -144,6 +149,7 @@ export const themeGuide: ThemeCollectionItem = defineCollection({
'replace-assets',
'seo',
'sitemap',
+ 'llmstxt',
],
},
{
diff --git a/docs/.vuepress/collections/zh/theme-guide.ts b/docs/.vuepress/collections/zh/theme-guide.ts
index 67cbdcb5..bcfadf05 100644
--- a/docs/.vuepress/collections/zh/theme-guide.ts
+++ b/docs/.vuepress/collections/zh/theme-guide.ts
@@ -41,12 +41,17 @@ export const themeGuide: ThemeCollectionItem = defineCollection({
items: [
'basic',
'extensions',
+ 'attrs',
+ 'emoji',
+ 'math',
'table',
'icons',
'mark',
'plot',
'abbr',
'annotation',
+ 'container',
+ 'github-alerts',
'card',
'steps',
'file-tree',
@@ -144,6 +149,7 @@ export const themeGuide: ThemeCollectionItem = defineCollection({
'replace-assets',
'seo',
'sitemap',
+ 'llmstxt',
],
},
{
diff --git a/docs/.vuepress/themes/components/EmojiList.vue b/docs/.vuepress/themes/components/EmojiList.vue
new file mode 100644
index 00000000..f653b97d
--- /dev/null
+++ b/docs/.vuepress/themes/components/EmojiList.vue
@@ -0,0 +1,87 @@
+
+
+
+
+
+ -
+
+ {{ rendered }}
+
+ {{ source }}
+
+
+
+
+
+
+
+ | header1 |
+ header2 |
+
+
+
+
+ | column1 |
+ column2 |
+
+
+
+```
+
+Table cells can also use attributes, commonly for cell merging:
+
+**Input:**
+
+```md
+| A | B | C | D |
+| ----------------------- | --- | --- | ---------------- |
+| 1 | 11 | 111 | 1111 {rowspan=3} |
+| 2 {colspan=2 rowspan=2} | 22 | 222 | 2222 |
+| 3 | 33 | 333 | 3333 |
+```
+
+**Output:**
+
+```html
+
+
+
+ | A |
+ B |
+ C |
+ D |
+
+
+
+
+ | 1 |
+ 11 |
+ 111 |
+ 1111 |
+
+
+ | 2 |
+ 22 |
+
+
+ | 3 |
+
+
+
+```
+
+**Result:**
+
+| A | B | C | D |
+| ----------------------- | --- | --- | ---------------- |
+| 1 | 11 | 111 | 1111 {rowspan=3} |
+| 2 {colspan=2 rowspan=2} | 22 | 222 | 2222 |
+| 3 | 33 | 333 | 3333 |
diff --git a/docs/en/guide/markdown/container.md b/docs/en/guide/markdown/container.md
new file mode 100644
index 00000000..3a749140
--- /dev/null
+++ b/docs/en/guide/markdown/container.md
@@ -0,0 +1,99 @@
+---
+title: container
+icon: mdi:message-text-outline
+createTime: 2025/11/29 14:53:21
+permalink: /en/guide/markdown/container/
+---
+
+::: tip Tip containers help you highlight important information in your documentation, making the content hierarchy clearer.
+:::
+
+Tip containers define different information display styles through type, title, and content.
+
+## Default Title Styles
+
+**Input Example:**
+
+```md
+::: note
+This is a note container
+:::
+
+::: info
+This is an info container
+:::
+
+::: tip
+This is a tip container
+:::
+
+::: warning
+This is a warning container
+:::
+
+::: caution
+This is a danger warning container
+:::
+
+::: details
+This is a details collapsible container
+:::
+```
+
+**Actual Effect:**
+
+::: note
+This is a note container
+:::
+
+::: info
+This is an info container
+:::
+
+::: tip
+This is a tip container
+:::
+
+::: warning
+This is a warning container
+:::
+
+::: caution
+This is a danger warning container
+:::
+
+::: details
+This is a details collapsible container
+:::
+
+## Custom Title Settings
+
+You can easily set custom titles by adding text after the container type.
+
+**Input Example:**
+
+````md
+::: caution STOP
+Danger zone, do not proceed
+:::
+
+::: details Click to view code
+```js
+console.log('Hello, VitePress!')
+```
+:::
+````
+
+**Actual Effect:**
+
+::: caution STOP
+Danger zone, do not proceed
+:::
+
+::: details Click to view code
+
+```js
+console.log('Hello, VuePress Plume!')
+```
+
+:::
diff --git a/docs/en/guide/markdown/emoji.md b/docs/en/guide/markdown/emoji.md
new file mode 100644
index 00000000..6f3a1464
--- /dev/null
+++ b/docs/en/guide/markdown/emoji.md
@@ -0,0 +1,66 @@
+---
+title: emoji
+icon: mdi:emoji-outline
+createTime: 2025/11/29 14:03:43
+permalink: /en/guide/markdown/emoji/
+---
+
+
+
+## Quick Start
+
+ๅจ Markdown ไธญไฝฟ็จ่กจๆ
็ฌฆๅท้ๅธธ็ฎๅ๏ผๅช้็จๅๅทๅ
่ฃน่กจๆ
ไปฃ็ ๅณๅฏ๏ผ
+
+**Input๏ผ**
+
+```md
+:tada: :100:
+```
+
+**Output๏ผ**
+
+:tada: :100:
+
+## Full Emoji List
+
+We provide complete emoji support based on the [markdown-it-emoji](https://github.com/markdown-it/markdown-it-emoji) plugin.
+
+[To view all available emoji codes, visit: **๐Complete Emoji Code List**](https://github.com/markdown-it/markdown-it-emoji/blob/master/lib/data/full.mjs){.read-more}
+
+::: tip Click the emoji to copy the emoji symbol to the clipboard.
+:::
+
+### People
+
+
+
+### Nature
+
+
+
+### Foods
+
+
+
+### Place
+
+
+
+### Activity
+
+
+
+### Symbol
+
+
+
+### Object
+
+
+
+### Flag
+
+
diff --git a/docs/en/guide/markdown/extensions.md b/docs/en/guide/markdown/extensions.md
index 83fb537e..777c4dc0 100644
--- a/docs/en/guide/markdown/extensions.md
+++ b/docs/en/guide/markdown/extensions.md
@@ -26,7 +26,9 @@ This allows linking to the header as `#my-anchor` instead of the default `#using
Internal and external links are specially processed.
-The theme automatically generates a new link for each md file and stores it in the `permalink` of the corresponding md file's frontmatter. You can modify these links at any time. You can also disable this feature via the `theme.autoFrontmatter` option, reverting to VuePress's default behavior.
+The theme automatically generates a new link for each md file and stores it in the `permalink` of the corresponding md file's frontmatter.
+You can modify these links at any time.
+You can also disable this feature via the `theme.autoFrontmatter` option, reverting to VuePress's default behavior.
### Internal Links
@@ -34,7 +36,8 @@ There are three ways to use internal links:
- Use the generated `permalink` as the target for the internal link.
- Use the relative path of the md file as the target for the internal link.
-- Use the absolute path of the md file as the target for the internal link. The absolute path `/` indicates starting from the `${sourceDir}` directory.
+- Use the absolute path of the md file as the target for the internal link.
+ The absolute path `/` indicates starting from the `${sourceDir}` directory.
```md
[Markdown](/guide/markdown/)
@@ -74,20 +77,6 @@ External links have `target="_blank" rel="noreferrer"`:
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
-## Emoji :tada:
-
-**Input:**
-
-```md
-:tada: :100:
-```
-
-**Output:**
-
-:tada: :100:
-
-You can find the [list of all supported emojis](https://github.com/markdown-it/markdown-it-emoji/blob/master/lib/data/full.mjs ) here.
-
## Table of Contents
**Input:**
@@ -100,168 +89,6 @@ You can find the [list of all supported emojis](https://github.com/markdown-it/m
[[TOC]]
-## Custom Containers
-
-Custom containers can be defined by their type, title, and content.
-
-### Default Title
-
-**Input:**
-
-```md
-::: note
-This is a note box
-:::
-
-::: info
-This is an info box.
-:::
-
-::: tip
-This is a tip.
-:::
-
-::: warning
-This is a warning.
-:::
-
-::: caution
-This is a dangerous warning.
-:::
-
-::: details
-This is a details block.
-:::
-```
-
-**Output:**
-
-::: note
-This is a note box
-:::
-
-::: info
-This is an info box.
-:::
-
-::: tip
-This is a tip.
-:::
-
-::: warning
-This is a warning.
-:::
-
-::: caution
-This is a dangerous warning.
-:::
-
-::: details
-This is a details block.
-:::
-
-### Custom Title
-
-You can set a custom title by appending text after the container's "type".
-
-**Input:**
-
-````md
-::: caution STOP
-Danger zone, do not proceed
-:::
-
-::: details Click to view code
-```js
-console.log('Hello, VitePress!')
-```
-:::
-````
-
-**Output:**
-
-::: caution STOP
-Danger zone, do not proceed
-:::
-
-::: details Click to view code
-
-```js
-console.log('Hello, VitePress!')
-```
-
-:::
-
-## GitHub-Style Alerts
-
-The theme also supports rendering [GitHub-style alerts](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts ). They are rendered in the same way as [custom containers](#custom-containers).
-
-**Input:**
-
-```md
-> [!NOTE]
-> Emphasizes important information that users should know even when skimming the document.
-
-> [!TIP]
-> Advisory information that helps users achieve their goals more smoothly.
-
-> [!IMPORTANT]
-> Information crucial for users to achieve their goals.
-
-> [!WARNING]
-> Key content that requires immediate user attention due to potential risks.
-
-> [!CAUTION]
-> Negative impacts of certain actions.
-```
-
-**Output:**
-
-> [!NOTE]
-> Emphasizes important information that users should know even when skimming the document.
-
-> [!TIP]
-> Advisory information that helps users achieve their goals more smoothly.
-
-> [!IMPORTANT]
-> Information crucial for users to achieve their goals.
-
-> [!WARNING]
-> Key content that requires immediate user attention due to potential risks.
-
-> [!CAUTION]
-> Negative impacts of certain actions.
-
-## Mathematical Equations
-
-**Input:**
-
-````
-When $a \ne 0$, there are two solutions to $(ax^2 + bx + c = 0)$ and they are
-$$ x = {-b \pm \sqrt{b^2-4ac} \over 2a} $$
-
-**Maxwell's equations:**
-
-| equation | description |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
-| $\nabla \cdot \vec{\mathbf{B}} = 0$ | divergence of $\vec{\mathbf{B}}$ is zero |
-| $\nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t} = \vec{\mathbf{0}}$ | curl of $\vec{\mathbf{E}}$ is proportional to the rate of change of $\vec{\mathbf{B}}$ |
-| $\nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} = \frac{4\pi}{c}\vec{\mathbf{j}} \nabla \cdot \vec{\mathbf{E}} = 4 \pi \rho$ | _wha?_ |
-````
-
-**Output:**
-
-When $a \ne 0$, there are two solutions to $(ax^2 + bx + c = 0)$ and they are
-$$ x = {-b \pm \sqrt{b^2-4ac} \over 2a} $$
-
-**Maxwell's equations:**
-
-| equation | description |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
-| $\nabla \cdot \vec{\mathbf{B}} = 0$ | divergence of $\vec{\mathbf{B}}$ is zero |
-| $\nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t} = \vec{\mathbf{0}}$ | curl of $\vec{\mathbf{E}}$ is proportional to the rate of change of $\vec{\mathbf{B}}$ |
-| $\nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} = \frac{4\pi}{c}\vec{\mathbf{j}} \nabla \cdot \vec{\mathbf{E}} = 4 \pi \rho$ | _wha?_ |
-
## Superscripts and Subscripts
- Use `^ ^` for superscript notation.
@@ -311,32 +138,6 @@ Centered content
Right-aligned content
:::
-## Attribute Support
-
-You can use special syntax to add attributes to Markdown elements.
-
-**Adding attributes to an image:**
-
-This adds a class attribute named `full-width` and a `width` attribute with the value `100%` to the image.
-
-```md
-{.full-width width="100%"}
-```
-
-Other attributes are also supported:
-
-```md
-A paragraph with text. {#p .a .b align=center customize-attr="content with spaces"}
-```
-
-This will be rendered as:
-
-```html
-
- A paragraph with text.
-
-```
-
## Task Lists
**Input:**
diff --git a/docs/en/guide/markdown/github-alerts.md b/docs/en/guide/markdown/github-alerts.md
new file mode 100644
index 00000000..8b40aea6
--- /dev/null
+++ b/docs/en/guide/markdown/github-alerts.md
@@ -0,0 +1,47 @@
+---
+title: github-alerts
+createTime: 2025/11/29 21:20:21
+permalink: /en/guide/markdown/github-alerts/
+---
+
+## GitHub-Style Alerts
+
+The theme supports rendering
+[GitHub-style alerts](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts)
+through callouts. They are rendered in the same way as [hint containers](./container.md).
+
+**Input:**
+
+```md
+> [!NOTE]
+> Highlights information that users should take note of even when skimming.
+
+> [!TIP]
+> Optional information to help users be more successful.
+
+> [!IMPORTANT]
+> Crucial information necessary for users to succeed.
+
+> [!WARNING]
+> Critical content demanding immediate user attention due to potential risks.
+
+> [!CAUTION]
+> Advises about negative outcomes from specific actions.
+```
+
+**Output:**
+
+> [!NOTE]
+> Highlights information that users should take note of even when skimming.
+
+> [!TIP]
+> Optional information to help users be more successful.
+
+> [!IMPORTANT]
+> Crucial information necessary for users to succeed.
+
+> [!WARNING]
+> Critical content demanding immediate user attention due to potential risks.
+
+> [!CAUTION]
+> Advises about negative outcomes from specific actions.
diff --git a/docs/en/guide/markdown/icons.md b/docs/en/guide/markdown/icons.md
index c3a20592..ca0256fd 100644
--- a/docs/en/guide/markdown/icons.md
+++ b/docs/en/guide/markdown/icons.md
@@ -3,9 +3,6 @@ title: Icons
createTime: 2025/10/08 14:49:39
icon: grommet-icons:emoji
permalink: /en/guide/markdown/icon/
-badge:
- text: Changed
- type: warning
---
-::: warning Breaking Change in `1.0.0-rc.144`
-
-The `:[collect:name size/color]:` syntax has been deprecated. Please use `::collect:name =size /color::` instead.
-
-The theme plans to support icon libraries such as `iconfont`, `fontawesome`, and `lucide` in future versions.
-The original syntax was insufficient for these new extensions, making this breaking change necessary.
-
-The old syntax remains supported in recent versions but is no longer recommended and will be removed in the future.
-
-The theme detects if the old syntax is used. If so, it will output warning messages and modification
-suggestions in the console. Please adjust according to these suggestions.
-
-:::
-
## Overview
The theme supports icons from the following sources in Markdown files:
diff --git a/docs/en/guide/markdown/math.md b/docs/en/guide/markdown/math.md
new file mode 100644
index 00000000..72512bab
--- /dev/null
+++ b/docs/en/guide/markdown/math.md
@@ -0,0 +1,148 @@
+---
+title: Mathematical Formulas
+icon: tabler:math
+createTime: 2025/11/29 21:36:22
+permalink: /en/guide/markdown/math/
+---
+
+## Overview
+
+The theme has built-in support for mathematical formulas.
+
+This feature is powered by [@vuepress/plugin-markdown-math](https://ecosystem.vuejs.press/zh/plugins/markdown/markdown-math.html).
+You can choose to render mathematical formulas in markdown using the following methods:
+
+- `katex` (default)
+- `mathjax`
+
+## Usage
+
+```ts title=".vuepress/config.ts"
+export default defineUserConfig({
+ theme: plumeTheme({
+ markdown: {
+ math: {
+ type: 'katex', // 'katex' | 'mathjax'
+ // ... Other configuration options
+ }
+ },
+ })
+})
+```
+
+When you choose to use `mathjax`, you also need to install the dependency by running the following command:
+
+::: npm-to
+
+```sh
+npm i @mathjax/src
+```
+
+:::
+
+## Syntax
+
+### Inline Syntax
+
+Use `$` to wrap mathematical formulas *(i.e., write the mathematical formula between two `$` symbols)*
+
+::: demo markdown title="Inline Mode" expanded
+
+```md
+Euler's identity $e^{i\pi}+1=0$ is a beautiful formula in $\mathbb{R}^2$.
+```
+
+:::
+
+### Block Syntax
+
+Use `$$` to wrap mathematical formulas *(i.e., write the mathematical formula between two `$$` symbols)*
+
+```md /$$/
+
+$$xxx$$
+
+
+$$
+xxx
+$$
+```
+
+:::demo markdown title="Block Mode" expanded
+
+```md
+$$
+\frac {\partial^r} {\partial \omega^r} \left(\frac {y^{\omega}} {\omega}\right)
+= \left(\frac {y^{\omega}} {\omega}\right) \left\{(\log y)^r + \sum_{i=1}^r \frac {(-1)^ Ir \cdots (r-i+1) (\log y)^{ri}} {\omega^i} \right\}
+$$
+```
+
+:::
+
+## Related Tutorials
+
+### TeX
+
+[TeX Tutorial](https://www.overleaf.com/learn/latex/Learn_LaTeX_in_30_minutes){.readmore}
+[TeX Cheat Sheet](https://mdit-plugins.github.io/zh/tex.html#tex-tutorial){.readmore}
+
+### KaTeX
+
+[KaTeX Supported Features](https://katex.org/docs/supported.html){.readmore}
+[KaTeX Support Table](https://katex.org/docs/support_table.html){.readmore}
+
+### MathJax
+
+[Supported TeX / KaTeX Commands](https://docs.mathjax.org/en/latest/input/tex/macros/index.html#tex-commands){.readmore}
+
+## Configuration Options
+
+:::: field-group
+::: field name="type" type="'katex' | 'mathjax'" default="'katex'"
+
+Package used to render $\TeX$ content.
+
+- `'katex'`: Use [KaTeX](https://katex.org/)
+- `'mathjax'`: Use [MathJax](https://www.mathjax.org/)
+:::
+:::field name="delimiters" type="'brackets' | 'dollars' | 'all'" default="'dollars'" optional
+Enabled math delimiter syntax.
+ - `"brackets"`: Use `\(...\)` for inline math and `\[...\]` for display mode math (LaTeX style)
+ - `"dollars"`: Use `$...$` for inline math and `$$...$$` for display mode math (common Markdown style)
+ - `"all"`: Enable both bracket and dollar sign syntax
+:::
+::::
+
+### Using KaTeX
+
+When using KaTeX, any other options will be passed to KaTeX as `KatexOptions`. For all available options, refer to the [KaTeX documentation](https://katex.org/docs/options.html).
+
+Additionally, 2 special options are supported:
+
+:::: field-group
+::: field name="copy" type="boolean" optional default="false"
+Whether to enable the copy extension.
+:::
+::: field name="mhchem" type="boolean" optional default="false"
+Whether to enable the mhchem extension.
+:::
+::::
+
+### Using MathJax
+
+When using MathJax, you can set:
+
+:::: field-group
+:::field name="tex" type="object" optional
+Options passed to the TeX input parser.
+:::
+::: field name="output" type="'svg' | 'chtml'" default="'svg'" optional
+Output format, either SVG or Common HTML.
+:::
+::: field name="chtml" type="object" optional
+Options passed to the Common HTML output parser.
+:::
+::: field name="svg" type="object" optional
+Options passed to the SVG output parser.
+:::
+::::
diff --git a/docs/en/guide/markdown/table.md b/docs/en/guide/markdown/table.md
index 261b4378..bfd5ab4f 100644
--- a/docs/en/guide/markdown/table.md
+++ b/docs/en/guide/markdown/table.md
@@ -290,6 +290,8 @@ Built-in `type` support: `tip`, `note`, `info`, `success`, `warning`, `danger`,
### Table Cell Highlighting
+#### Method One
+
**Input:**
```md
@@ -314,6 +316,34 @@ Built-in `type` support: `tip`, `note`, `info`, `success`, `warning`, `danger`,
:::
+#### Method Two
+
+Using the [Attribute Support](./attrs.md) syntax
+
+**Input:**
+
+```md
+::: table title="This is the Table Title"
+| (1,1) {.danger} | (1,2) | (1,3) | (1,4) {.warning} |
+| ------------------ | ------------------ | ---------------- | ----------------- |
+| (2,1) | (2,2) {.danger} | (2,3) {.warning} | (2,4) |
+| (3,1) | (3,2) {.important} | (3,3) {.danger} | (3,4) |
+| (4,1) {.important} | (4,2) | (4,3) | (4,4) {.danger} |
+:::
+```
+
+**Output:**
+
+::: table title="This is the Table Title"
+
+| (1,1) {.danger} | (1,2) | (1,3) | (1,4) {.warning} |
+| ------------------ | ------------------ | ---------------- | ----------------- |
+| (2,1) | (2,2) {.danger} | (2,3) {.warning} | (2,4) |
+| (3,1) | (3,2) {.important} | (3,3) {.danger} | (3,4) |
+| (4,1) {.important} | (4,2) | (4,3) | (4,4) {.danger} |
+
+:::
+
## Custom Highlight Types
In [Custom CSS Styles](../custom/style.md), custom highlight types can be defined using the following format:
@@ -363,3 +393,29 @@ This custom type can then be used in tables:
| Cell 4 | Cell 5 | Cell 6 |
:::
+
+## Table Cell Merging
+
+Table cell merging is implemented through the attribute syntax supported by [markdown-it-attrs](https://github.com/arve0/markdown-it-attrs).
+Therefore, it does not need to be used within the `:::table` container; you can use it in any table.
+
+Inside a table cell, add `rowspan=rows` or `colspan=cols` (or a combination) using
+the attribute syntax `{}` at the end of the cell content to achieve table cell merging.
+
+**Input:**
+
+```md
+| A | B | C | D |
+| ----------------------- | --- | --- | ---------------- |
+| 1 | 11 | 111 | 1111 {rowspan=3} |
+| 2 {colspan=2 rowspan=2} | 22 | 222 | 2222 |
+| 3 | 33 | 333 | 3333 |
+```
+
+**Output:**
+
+| A | B | C | D |
+| ----------------------- | --- | --- | ---------------- |
+| 1 | 11 | 111 | 1111 {rowspan=3} |
+| 2 {colspan=2 rowspan=2} | 22 | 222 | 2222 |
+| 3 | 33 | 333 | 3333 |
diff --git a/docs/en/guide/quick-start/usage.md b/docs/en/guide/quick-start/usage.md
index 95c47c6a..1a6c8866 100644
--- a/docs/en/guide/quick-start/usage.md
+++ b/docs/en/guide/quick-start/usage.md
@@ -10,10 +10,10 @@ tags:
## Environment Requirements
-- [Node.js](https://nodejs.org/): **^20.6.0 or >= 22.0.0** [+node-versions]
+- [Node.js](https://nodejs.org/): **^20.19.0 or >= 22.0.0** [+node-versions]
- Package Manager: [npm 8+](https://www.npmjs.com/), [pnpm 8+](https://pnpm.io/), or [Yarn 2+](https://yarnpkg.com/)
-[+node-versions]: **^20.6.0:** Versions `20.6.0` and above but below `21.0.0`
+[+node-versions]: **^20.19.0:** Versions `20.19.0` and above but below `21.0.0`
[+node-versions]: **>= 22.0.0:** Versions `22.0.0` and above
:::: details How to Install Environment Dependencies?
diff --git a/docs/guide/features/llmstxt.md b/docs/guide/features/llmstxt.md
new file mode 100644
index 00000000..02fb090e
--- /dev/null
+++ b/docs/guide/features/llmstxt.md
@@ -0,0 +1,105 @@
+---
+title: LLMs txt
+icon: ri:ai
+createTime: 2025/12/01 10:45:29
+permalink: /guide/features/llmstxt/
+---
+
+## ๆฆ่ฟฐ
+
+ไธบ็ซ็นๆทปๅ [llms.txt](https://llmstxt.org/)๏ผไปฅๆไพๅฏน LLM ๅๅฅฝ็ๅ
ๅฎนใ
+
+**ๅ
ณ่ๆไปถ**๏ผ [@vuepress/plugin-llms](https://ecosystem.vuejs.press/zh/plugins/ai/llms.html)
+
+## ไธบไปไน้่ฆ llms.txt๏ผ
+
+ๅคงๅ่ฏญ่จๆจกๅ่ถๆฅ่ถไพ่ต็ฝ็ซไฟกๆฏ๏ผไฝ้ขไธดไธไธชๅ
ณ้ฎ้ๅถ๏ผไธไธๆ็ชๅฃๅคชๅฐ๏ผๆ ๆณๅฎๆดๅค็ๅคงๅคๆฐ็ฝ็ซใๅฐๅ
ๅซๅฏผ่ชใๅนฟๅๅ JavaScript ็ๅคๆ HTML ้กต้ข่ฝฌๆขไธบ้ๅ LLM ็็บฏๆๆฌๆขๅฐ้พๅไธ็ฒพ็กฎใ
+
+่ฝ็ถ็ฝ็ซๅๆถไธบไบบ็ฑป่ฏป่
ๅ LLM ๆๅก๏ผไฝๅ่
ๅ็ไบๅจไธไธชๅฏ่ฎฟ้ฎ็ไฝ็ฝฎๆถ้็ๆด็ฎๆดใไธๅฎถ็บง็ไฟกๆฏใ่ฟๅฏนไบๅผๅ็ฏๅข็ญไฝฟ็จๆกไพๅฐคๅ
ถ้่ฆ๏ผๅ ไธบ LLM ้่ฆๅฟซ้่ฎฟ้ฎ็ผ็จๆๆกฃๅ APIใ
+
+ๅ็ฝ็ซๆทปๅ `/llms.txt` Markdown ๆไปถ๏ผไปฅๆไพๅฏน LLM ๅๅฅฝ็ๅ
ๅฎนใๆญคๆไปถๆไพไบ็ฎ็ญ็่ๆฏไฟกๆฏใๆๅๅๆๅ่ฏฆ็ป Markdown ๆไปถ็้พๆฅใ
+
+## ๅ่ฝ
+
+ๆไปถ้่ฟๆฃ็ดขไฝ ็ๆๆกฃๆบ็ฎๅฝไธญ็ๆๆ Markdown ๆไปถ๏ผๅนถๅฐๅ
ถ่ฝฌๆขไธบ LLM ๅๅฅฝ็็บฏๆๆฌๆไปถใ
+
+::: file-tree
+
+- .vuepress/dist
+ - llms.txt
+ - llms-full.txt
+ - markdown-examples.html
+ - markdown-examples.md
+ - โฆ
+:::
+
+็นๅปไปฅไธ้พๆฅๆฅ็ๆฌๆๆกฃ็ซ็น็ llms.txt ๆไปถ๏ผ
+
+- [llms.txt](/llms.txt){.no-icon}
+- [llms-full.txt](/llms-full.txt){.no-icon}
+
+::: tip
+ๆไปถไป
ๅจ็ไบงๆๅปบๆถ๏ผๅณๆง่ก `vuepress build` ๅฝไปคๆถ๏ผ็ๆ `llms.txt` ๆไปถ๏ผไปฅๅๅ
ถๅฎ LLM ๅๅฅฝ็ๆๆกฃๆไปถ๏ผๅนถๅฐๅฎไปฌ่พๅบๅฐ `.vuepress/dist` ็ฎๅฝไธญใ
+
+:::
+
+[ๅฎๆดๅ่ฝ่ฏดๆ่ฏทๆฅ็ **ๆไปถๅฎๆนๆๆกฃ**](https://ecosystem.vuejs.press/zh/plugins/ai/llms.html#%E6%8F%92%E4%BB%B6%E5%8A%9F%E8%83%BD){.read-more}
+
+## ้
็ฝฎ
+
+ไธป้ข้ป่ฎคไธๅฏ็จๆญคๅ่ฝ๏ผไฝ ๅฏไปฅ้่ฟ `llmstxt` ้
็ฝฎ้กนๅฏ็จๅฎ๏ผ
+
+```ts title=".vuepress/config.ts"
+import { defineUserConfig } from 'vuepress'
+import { plumeTheme } from 'vuepress-theme-plume'
+
+export default defineUserConfig({
+ theme: plumeTheme({
+ // ไฝฟ็จไธป้ขๅ
็ฝฎ็้ป่ฎค้
็ฝฎ
+ // llmstxt: true,
+
+ // ไฝฟ็จ่ชๅฎไน้
็ฝฎ
+ llmstxt: {
+ locale: '/',
+ // ...ๅ
ถๅฎ้
็ฝฎ
+ },
+
+ // ไนๅฏไปฅๅจ `plugins.llmstxt` ้
็ฝฎ๏ผไฝไธๆจ่
+ plugins: {
+ llmstxt: true
+ }
+ }),
+})
+```
+
+[ๅฎๆด้
็ฝฎ้กน่ฏดๆ่ฏทๆฅ็ **ๆไปถๅฎๆนๆๆกฃ**](https://ecosystem.vuejs.press/zh/plugins/ai/llms.html#options){.read-more}
+
+## ็ปไปถ
+
+ไธบ่ฟไธๆญฅๅขๅผบ ๆๆกฃ็ซ็น ไธ LLMs ็ไบๅจ๏ผไฝ ๅฏไปฅๅจๆๆกฃ็ซ็นไธญๆทปๅ `` ็ปไปถใ
+่ฏฅ็ปไปถไธไฝไธบๅ
็ฝฎ็ปไปถ๏ผ่ๆฏไธป้ข้ขๅค็ `features` ๅฎ็ฐ๏ผๅ ๆญคไฝ ้่ฆๆๅจๅผๅ
ฅๅฎ๏ผ
+ๅนถๅจๅ้็ไฝ็ฝฎ๏ผ้่ฟ [็ปไปถๆๆงฝ](../../guide/custom/slots.md) ๆทปๅ ๅฐๆๆกฃ็ซ็นไธญ๏ผ
+
+```ts title=".vuepress/client.ts"
+import { defineAsyncComponent, h } from 'vue'
+import { Layout } from 'vuepress-theme-plume/client'
+import PageContextMenu from 'vuepress-theme-plume/features/PageContextMenu.vue' // [!code ++]
+import { defineClientConfig } from 'vuepress/client'
+
+export default defineClientConfig({
+ layouts: {
+ Layout: h(Layout, null, {
+ // ๅฐ PageContextMenu ๆทปๅ ๅฐ doc-title-after ๆๆงฝ๏ผๅณๆ็ซ ๆ ้ข็ๅณไพง
+ 'doc-title-after': () => h(PageContextMenu), // [!code ++]
+ }),
+ },
+})
+```
+
+ไฝ ๅฏไปฅๅจๅฝๅ้กต้ข็ๆ ้ข็ๅณไพง๏ผไฝ้ช่ฏฅ็ปไปถ็ๅ่ฝใ
+
+::: important
+ๆญค็ปไปถๅฎๅ
จไพ่ตไบ `@vuepress/plugin-llms` ๆไปถ๏ผไป
ๅฝไฝ ๅฏ็จไบๆญคๆไปถๅ่ฝๅ๏ผๆ่ฝไฝฟ็จๅฎใ
+
+ๅ ๆญค๏ผๆญค็ปไปถๆไพ็ๅ่ฝ **ไป
ๅจๆๅปบๅ็็ไบงๅ
ไธญๆๅฏ็จ** ใ
+:::
diff --git a/docs/guide/markdown/attrs.md b/docs/guide/markdown/attrs.md
new file mode 100644
index 00000000..78f7a2a3
--- /dev/null
+++ b/docs/guide/markdown/attrs.md
@@ -0,0 +1,187 @@
+---
+title: ๅฑๆงๆฏๆ
+icon: ic:outline-data-object
+createTime: 2025/11/30 18:02:41
+permalink: /guide/markdown/attrs/
+---
+
+## ๆฆ่ฟฐ
+
+ไธบไฝ ็Markdownๆทปๅ ็ฑปใๆ ่ฏ็ฌฆๅๅฑๆงใ
+
+**ๆญคๅ่ฝ้ป่ฎคๅฏ็จใ**
+
+## ่ฏญๆณ
+
+ๅจ Markdown ็ๆ ่ฎฐๅไฝฟ็จ `{ }` ๆทปๅ ็ฑปๅใๆ ่ฏ็ฌฆ ๆ ๅฑๆงใ
+
+```md
+markdown ่ฏญๅฅ{.classname #id attr1=value attr2="ๅธฆ็ฉบๆ ผ็ๅผ"}
+```
+
+### `.classname`
+
+ไปฅ `.` ไฝไธบ่ตทๅง๏ผๆทปๅ ไธไธช็ฑปๅ
+
+**่พๅ
ฅ๏ผ**
+
+```md
+__ๅ ็ฒ__{.bolder}
+```
+
+**่พๅบ๏ผ**
+
+```html
+ๅ ็ฒ
+```
+
+### `#id`
+
+ไปฅ `#` ไฝไธบ่ตทๅง๏ผๆทปๅ ไธไธช ID
+
+**่พๅ
ฅ๏ผ**
+
+```md
+## ๆ ้ข{#header-1}
+```
+
+**่พๅบ๏ผ**
+
+```html
+
+```
+
+:::tip ๆญคๆๅทงๅธธ็จไบ่ชๅฎไนๆ ้ข็้็น้พๆฅ
+:::
+
+### `attr=value`
+
+**่พๅ
ฅ๏ผ**
+
+```md
+[้พๆฅ](https://example.com){target=_blank}
+[้พๆฅ](https://example.com){rel="noopener noreferrer"}
+```
+
+**่พๅบ๏ผ**
+
+```html
+้พๆฅ
+้พๆฅ
+```
+
+### ็ปๅไฝฟ็จ
+
+**่พๅ
ฅ๏ผ**
+
+```md
+[้พๆฅ](https://example.com){.link #linkId target=_blank rel="noopener noreferrer"}
+```
+
+**่พๅบ๏ผ**
+
+```html
+้พๆฅ
+```
+
+### ๅจๅ็บงๆ ่ฎฐไธ
+
+ๅจๅ็บงๆ ่ฎฐ็ไธไธ่กๆทปๅ ๅฑๆงใ
+
+ๆฏๅฆๅจ ๆ ๅบๅ่กจ ไธไฝฟ็จ
+
+**่พๅ
ฅ๏ผ**
+
+```md
+- list item **bold**
+{.red}
+```
+
+**่พๅบ๏ผ**
+
+```html
+
+```
+
+ๆฏๅฆๅจ ่กจๆ ผ ไธไฝฟ็จ
+
+**่พๅ
ฅ๏ผ**
+
+```md
+| header1 | header2 |
+| ------- | ------- |
+| column1 | column2 |
+
+{.special}
+```
+
+**่พๅบ๏ผ**
+
+```html
+
+
+
+ | header1 |
+ header2 |
+
+
+
+
+ | column1 |
+ column2 |
+
+
+
+```
+
+่กจๆ ผไธญ็ๅๅ
ๆ ผไนๅฏไปฅไฝฟ็จ๏ผๅธธ่งไบ ๅๅนถๅๅ
ๆ ผ๏ผ
+
+**่พๅ
ฅ๏ผ**
+
+```md
+| A | B | C | D |
+| ----------------------- | --- | --- | ---------------- |
+| 1 | 11 | 111 | 1111 {rowspan=3} |
+| 2 {colspan=2 rowspan=2} | 22 | 222 | 2222 |
+| 3 | 33 | 333 | 3333 |
+```
+
+**่พๅบ๏ผ**
+
+```html
+
+
+
+ | A |
+ B |
+ C |
+ D |
+
+
+
+
+ | 1 |
+ 11 |
+ 111 |
+ 1111 |
+
+
+ | 2 |
+ 22 |
+
+
+ | 3 |
+
+
+
+```
+
+**ๆๆ๏ผ**
+
+| A | B | C | D |
+| ----------------------- | --- | --- | ---------------- |
+| 1 | 11 | 111 | 1111 {rowspan=3} |
+| 2 {colspan=2 rowspan=2} | 22 | 222 | 2222 |
+| 3 | 33 | 333 | 3333 |
diff --git a/docs/guide/markdown/container.md b/docs/guide/markdown/container.md
new file mode 100644
index 00000000..ebc58bc6
--- /dev/null
+++ b/docs/guide/markdown/container.md
@@ -0,0 +1,99 @@
+---
+title: ๆ็คบๅฎนๅจ
+icon: mdi:message-text-outline
+createTime: 2025/11/29 14:42:46
+permalink: /guide/markdown/container/
+---
+
+::: tip ๆ็คบๅฎนๅจ่ฝๅคๅธฎๅฉไฝ ๅจๆๆกฃไธญ็ชๅบๆพ็คบ้่ฆไฟกๆฏ๏ผ่ฎฉๅ
ๅฎนๅฑๆฌกๆดๅ ๆธ
ๆฐใ
+:::
+
+ๆ็คบๅฎนๅจ้่ฟ็ฑปๅใๆ ้ขๅๅ
ๅฎนๆฅๅฎไนไธๅ็ไฟกๆฏๅฑ็คบๆ ทๅผใ
+
+## ้ป่ฎคๆ ้ขๆ ทๅผ
+
+**่พๅ
ฅ็คบไพ๏ผ**
+
+```md
+::: note
+่ฟๆฏไธไธชๆณจ้ๆก
+:::
+
+::: info
+่ฟๆฏไธไธชไฟกๆฏๆก
+:::
+
+::: tip
+่ฟๆฏไธไธชๆ็คบๆก
+:::
+
+::: warning
+่ฟๆฏไธไธช่ญฆๅๆก
+:::
+
+::: caution
+่ฟๆฏไธไธชๅฑ้ฉ่ญฆๅๆก
+:::
+
+::: details
+่ฟๆฏไธไธช่ฏฆๆ
ๆๅ ๆก
+:::
+```
+
+**ๅฎ้
ๆๆ๏ผ**
+
+::: note
+่ฟๆฏไธไธชๆณจ้ๆก
+:::
+
+::: info
+่ฟๆฏไธไธชไฟกๆฏๆก
+:::
+
+::: tip
+่ฟๆฏไธไธชๆ็คบๆก
+:::
+
+::: warning
+่ฟๆฏไธไธช่ญฆๅๆก
+:::
+
+::: caution
+่ฟๆฏไธไธชๅฑ้ฉ่ญฆๅๆก
+:::
+
+::: details
+่ฟๆฏไธไธช่ฏฆๆ
ๆๅ ๆก
+:::
+
+## ่ชๅฎไนๆ ้ข่ฎพ็ฝฎ
+
+้่ฟๅจๅฎนๅจ็ฑปๅๅๆทปๅ ๆๆฌ๏ผๅฏไปฅ่ฝปๆพ่ฎพ็ฝฎ่ชๅฎไนๆ ้ขใ
+
+**่พๅ
ฅ็คบไพ๏ผ**
+
+````md
+::: caution STOP
+ๅฑ้ฉๅบๅ๏ผ่ฏทๅฟ็ปง็ปญ
+:::
+
+::: details ็นๆๆฅ็ไปฃ็
+```js
+console.log('Hello, VitePress!')
+```
+:::
+````
+
+**ๅฎ้
ๆๆ๏ผ**
+
+::: caution STOP
+ๅฑ้ฉๅบๅ๏ผ่ฏทๅฟ็ปง็ปญ
+:::
+
+::: details ็นๆๆฅ็ไปฃ็
+
+```js
+console.log('Hello, VuePress Plume!')
+```
+
+:::
diff --git a/docs/guide/markdown/emoji.md b/docs/guide/markdown/emoji.md
new file mode 100644
index 00000000..a77dbc17
--- /dev/null
+++ b/docs/guide/markdown/emoji.md
@@ -0,0 +1,66 @@
+---
+title: emoji
+icon: mdi:emoji-outline
+createTime: 2025/11/29 14:03:43
+permalink: /guide/markdown/emoji/
+---
+
+
+
+## ๅฟซ้ไธๆ
+
+ๅจ Markdown ไธญไฝฟ็จ่กจๆ
็ฌฆๅท้ๅธธ็ฎๅ๏ผๅช้็จๅๅทๅ
่ฃน่กจๆ
ไปฃ็ ๅณๅฏ๏ผ
+
+**่พๅ
ฅ็คบไพ๏ผ**
+
+```md
+:tada: :100:
+```
+
+**ๆธฒๆๆๆ๏ผ**
+
+:tada: :100:
+
+## ๅฎๆด่กจๆ
ๅบ
+
+ๆไปฌๅบไบ [markdown-it-emoji](https://github.com/markdown-it/markdown-it-emoji) ๆไปถๆไพๅฎๆด็่กจๆ
็ฌฆๅทๆฏๆใ
+
+[ๅฆ้ๆฅ็ๆๆๅฏ็จ็่กจๆ
ไปฃ็ ๏ผ่ฏท่ฎฟ้ฎ๏ผ**๐ๅฎๆด่กจๆ
ไปฃ็ ๅ่กจ**](https://github.com/markdown-it/markdown-it-emoji/blob/master/lib/data/full.mjs){.read-more}
+
+::: tip ็นๅป emoji ่กจๆ
ๅณๅฏๅคๅถ่กจๆ
็ฌฆๅทๅฐๅช่ดดๆฟใ
+:::
+
+### ไบบ็ฉ
+
+
+
+### ่ช็ถ
+
+
+
+### ้ฃ็ฉ
+
+
+
+### ๅฐ็น
+
+
+
+### ๆดปๅจ
+
+
+
+### ็ฌฆๅท
+
+
+
+### ็ฉๅ
+
+
+
+### ๆๅธ
+
+
diff --git a/docs/guide/markdown/extensions.md b/docs/guide/markdown/extensions.md
index 071fc7ce..7a594d72 100644
--- a/docs/guide/markdown/extensions.md
+++ b/docs/guide/markdown/extensions.md
@@ -75,20 +75,6 @@ tags:
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
-## Emoji :tada:
-
-**่พๅ
ฅ๏ผ**
-
-```md
-:tada: :100:
-```
-
-**่พๅบ๏ผ**
-
-:tada: :100:
-
-่ฟ้ๅฏไปฅๆพๅฐ [ๆๆๆฏๆ็ emoji ๅ่กจ](https://github.com/markdown-it/markdown-it-emoji/blob/master/lib/data/full.mjs)ใ
-
## ็ฎๅฝ่กจ
**่พๅ
ฅ๏ผ**
@@ -101,168 +87,6 @@ tags:
[[TOC]]
-## ่ชๅฎไนๅฎนๅจ
-
-่ชๅฎไนๅฎนๅจๅฏไปฅ้่ฟๅฎไปฌ็็ฑปๅใๆ ้ขๅๅ
ๅฎนๆฅๅฎไนใ
-
-### ้ป่ฎคๆ ้ข
-
-**่พๅ
ฅ๏ผ**
-
-```md
-::: note
-This is a note box
-:::
-
-::: info
-This is an info box.
-:::
-
-::: tip
-This is a tip.
-:::
-
-::: warning
-This is a warning.
-:::
-
-::: caution
-This is a dangerous warning.
-:::
-
-::: details
-This is a details block.
-:::
-```
-
-**่พๅบ๏ผ**
-
-::: note
-This is a note box
-:::
-
-::: info
-This is an info box.
-:::
-
-::: tip
-This is a tip.
-:::
-
-::: warning
-This is a warning.
-:::
-
-::: caution
-This is a dangerous warning.
-:::
-
-::: details
-This is a details block.
-:::
-
-### ่ชๅฎไนๆ ้ข
-
-ๅฏไปฅ้่ฟๅจๅฎนๅจ็ "type" ไนๅ้ๅ ๆๆฌๆฅ่ฎพ็ฝฎ่ชๅฎไนๆ ้ขใ
-
-**่พๅ
ฅ๏ผ**
-
-````md
-::: caution STOP
-ๅฑ้ฉๅบๅ๏ผ่ฏทๅฟ็ปง็ปญ
-:::
-
-::: details ็นๆๆฅ็ไปฃ็
-```js
-console.log('Hello, VitePress!')
-```
-:::
-````
-
-**่พๅบ๏ผ**
-
-::: caution STOP
-ๅฑ้ฉๅบๅ๏ผ่ฏทๅฟ็ปง็ปญ
-:::
-
-::: details ็นๆๆฅ็ไปฃ็
-
-```js
-console.log('Hello, VitePress!')
-```
-
-:::
-
-## GitHub ้ฃๆ ผ็่ญฆๆฅ
-
-ไธป้ข ๅๆ ทๆฏๆไปฅๆ ๆณจ็ๆนๅผๆธฒๆ [GitHub ้ฃๆ ผ็่ญฆๆฅ](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts)ใๅฎไปฌๅ[่ชๅฎไนๅฎนๅจ](#่ชๅฎไนๅฎนๅจ)็ๆธฒๆๆนๅผ็ธๅใ
-
-**่พๅ
ฅ๏ผ**
-
-```md
-> [!NOTE]
-> ๅผบ่ฐ็จๆทๅจๅฟซ้ๆต่งๆๆกฃๆถไนไธๅบๅฟฝ็ฅ็้่ฆไฟกๆฏใ
-
-> [!TIP]
-> ๆๅฉไบ็จๆทๆด้กบๅฉ่พพๆ็ฎๆ ็ๅปบ่ฎฎๆงไฟกๆฏใ
-
-> [!IMPORTANT]
-> ๅฏน็จๆท่พพๆ็ฎๆ ่ณๅ
ณ้่ฆ็ไฟกๆฏใ
-
-> [!WARNING]
-> ๅ ไธบๅฏ่ฝๅญๅจ้ฃ้ฉ๏ผๆไปฅ้่ฆ็จๆท็ซๅณๅ
ณๆณจ็ๅ
ณ้ฎๅ
ๅฎนใ
-
-> [!CAUTION]
-> ่กไธบๅฏ่ฝๅธฆๆฅ็่ด้ขๅฝฑๅใ
-```
-
-**่พๅบ๏ผ**
-
-> [!NOTE]
-> ๅผบ่ฐ็จๆทๅจๅฟซ้ๆต่งๆๆกฃๆถไนไธๅบๅฟฝ็ฅ็้่ฆไฟกๆฏใ
-
-> [!TIP]
-> ๆๅฉไบ็จๆทๆด้กบๅฉ่พพๆ็ฎๆ ็ๅปบ่ฎฎๆงไฟกๆฏใ
-
-> [!IMPORTANT]
-> ๅฏน็จๆท่พพๆ็ฎๆ ่ณๅ
ณ้่ฆ็ไฟกๆฏใ
-
-> [!WARNING]
-> ๅ ไธบๅฏ่ฝๅญๅจ้ฃ้ฉ๏ผๆไปฅ้่ฆ็จๆท็ซๅณๅ
ณๆณจ็ๅ
ณ้ฎๅ
ๅฎนใ
-
-> [!CAUTION]
-> ่กไธบๅฏ่ฝๅธฆๆฅ็่ด้ขๅฝฑๅใ
-
-## ๆฐๅญฆๆน็จ
-
-**่พๅ
ฅ๏ผ**
-
-````
-When $a \ne 0$, there are two solutions to $(ax^2 + bx + c = 0)$ and they are
-$$ x = {-b \pm \sqrt{b^2-4ac} \over 2a} $$
-
-**Maxwell's equations:**
-
-| equation | description |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
-| $\nabla \cdot \vec{\mathbf{B}} = 0$ | divergence of $\vec{\mathbf{B}}$ is zero |
-| $\nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t} = \vec{\mathbf{0}}$ | curl of $\vec{\mathbf{E}}$ is proportional to the rate of change of $\vec{\mathbf{B}}$ |
-| $\nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} = \frac{4\pi}{c}\vec{\mathbf{j}} \nabla \cdot \vec{\mathbf{E}} = 4 \pi \rho$ | _wha?_ |
-````
-
-**่พๅบ๏ผ**
-
-When $a \ne 0$, there are two solutions to $(ax^2 + bx + c = 0)$ and they are
-$$ x = {-b \pm \sqrt{b^2-4ac} \over 2a} $$
-
-**Maxwell's equations:**
-
-| equation | description |
-| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
-| $\nabla \cdot \vec{\mathbf{B}} = 0$ | divergence of $\vec{\mathbf{B}}$ is zero |
-| $\nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t} = \vec{\mathbf{0}}$ | curl of $\vec{\mathbf{E}}$ is proportional to the rate of change of $\vec{\mathbf{B}}$ |
-| $\nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} = \frac{4\pi}{c}\vec{\mathbf{j}} \nabla \cdot \vec{\mathbf{E}} = 4 \pi \rho$ | _wha?_ |
-
## ไธไธ่งๆ
- ไฝฟ็จ `^ ^` ่ฟ่กไธ่งๆ ๆ ๆณจใ
@@ -312,32 +136,6 @@ $$ x = {-b \pm \sqrt{b^2-4ac} \over 2a} $$
ๅณๅฏน้ฝ็ๅ
ๅฎน
:::
-## ๅฑๆงๆฏๆ
-
-ไฝ ๅฏไปฅไฝฟ็จ็นๆฎๆ ่ฎฐไธบ Markdown ๅ
็ด ๆทปๅ ๅฑๆงใ
-
-**ไธบๅพ็ๆทปๅ ๅฑๆง๏ผ**
-
-่ฟๅฐไธบๅพ็ๆทปๅ ไธไธช ๅไธบ `full-width` ็ class ๅฑๆง๏ผไปฅๅไธไธช `width` ๅฑๆง๏ผๅผไธบ `100%`ใ
-
-```md
-{.full-width width="100%"}
-```
-
-ๅๆถไนๆฏๆๅ
ถไปๅฑๆง:
-
-```md
-ไธไธชๅ
ๅซๆๅญ็ๆฎต่ฝใ {#p .a .b align=center customize-attr="content with spaces"}
-```
-
-่ฟๅฐ่ขซๆธฒๆไธบ๏ผ
-
-```html
-
- ไธไธชๅ
ๅซๆๅญ็ๆฎต่ฝใ
-
-```
-
## ไปปๅกๅ่กจ
**่พๅ
ฅ๏ผ**
diff --git a/docs/guide/markdown/github-alerts.md b/docs/guide/markdown/github-alerts.md
new file mode 100644
index 00000000..249c8886
--- /dev/null
+++ b/docs/guide/markdown/github-alerts.md
@@ -0,0 +1,46 @@
+---
+title: Github ่ญฆๆฅ
+icon: mdi:alert-outline
+createTime: 2025/11/29 19:59:45
+permalink: /guide/markdown/github-alerts/
+---
+
+## GitHub ้ฃๆ ผ็่ญฆๆฅ
+
+ไธป้ขๆฏๆไปฅๆ ๆณจ็ๆนๅผๆธฒๆ [GitHub ้ฃๆ ผ็่ญฆๆฅ](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts)ใๅฎไปฌๅ[ๆ็คบๅฎนๅจ](./container.md)็ๆธฒๆๆนๅผ็ธๅใ
+
+**่พๅ
ฅ๏ผ**
+
+```md
+> [!NOTE]
+> ๅผบ่ฐ็จๆทๅจๅฟซ้ๆต่งๆๆกฃๆถไนไธๅบๅฟฝ็ฅ็้่ฆไฟกๆฏใ
+
+> [!TIP]
+> ๆๅฉไบ็จๆทๆด้กบๅฉ่พพๆ็ฎๆ ็ๅปบ่ฎฎๆงไฟกๆฏใ
+
+> [!IMPORTANT]
+> ๅฏน็จๆท่พพๆ็ฎๆ ่ณๅ
ณ้่ฆ็ไฟกๆฏใ
+
+> [!WARNING]
+> ๅ ไธบๅฏ่ฝๅญๅจ้ฃ้ฉ๏ผๆไปฅ้่ฆ็จๆท็ซๅณๅ
ณๆณจ็ๅ
ณ้ฎๅ
ๅฎนใ
+
+> [!CAUTION]
+> ่กไธบๅฏ่ฝๅธฆๆฅ็่ด้ขๅฝฑๅใ
+```
+
+**่พๅบ๏ผ**
+
+> [!NOTE]
+> ๅผบ่ฐ็จๆทๅจๅฟซ้ๆต่งๆๆกฃๆถไนไธๅบๅฟฝ็ฅ็้่ฆไฟกๆฏใ
+
+> [!TIP]
+> ๆๅฉไบ็จๆทๆด้กบๅฉ่พพๆ็ฎๆ ็ๅปบ่ฎฎๆงไฟกๆฏใ
+
+> [!IMPORTANT]
+> ๅฏน็จๆท่พพๆ็ฎๆ ่ณๅ
ณ้่ฆ็ไฟกๆฏใ
+
+> [!WARNING]
+> ๅ ไธบๅฏ่ฝๅญๅจ้ฃ้ฉ๏ผๆไปฅ้่ฆ็จๆท็ซๅณๅ
ณๆณจ็ๅ
ณ้ฎๅ
ๅฎนใ
+
+> [!CAUTION]
+> ่กไธบๅฏ่ฝๅธฆๆฅ็่ด้ขๅฝฑๅใ
diff --git a/docs/guide/markdown/icons.md b/docs/guide/markdown/icons.md
index 3c332dcb..17dba545 100644
--- a/docs/guide/markdown/icons.md
+++ b/docs/guide/markdown/icons.md
@@ -3,9 +3,6 @@ title: ๅพๆ
createTime: 2024/09/30 14:49:39
icon: grommet-icons:emoji
permalink: /guide/markdown/icon/
-badge:
- text: ๅๆด
- type: warning
---
-::: warning ๅพๆ ่ฏญๆณ็ณๅจ `1.0.0-rc.144` ็ๆฌไธญ่ฟ่กไบ็ ดๅๆงๅๆดใ
-
-`:[collect:name size/color]:` ่ฏญๆณ็ณๅทฒๅผ็จ๏ผ่ฏทไฝฟ็จ `::collect:name =size /color::` ไปฃๆฟใ
-
-ไธป้ข่ฎกๅๅจๆชๆฅ็็ๆฌไธญ๏ผๆฏๆๅฆ `iconfont` / `fontawesome` / `lucide` ็ญๅพๆ ๅบ็ๅพๆ ๏ผๅๆ่ฏญๆณ็ณ
-ไธ่ถณไปฅๆฏๆๆฐ็ๆฉๅฑ๏ผๅ ๆญคๆญค็ ดๅๆงๅๆดๆฏๅฟ
่ฆ็ใ
-
-ๆง็่ฏญๆณๅจ่ฟๆ็็ๆฌไธญไพ็ถๆฏๆ๏ผไฝไธๅๆจ่ไฝฟ็จ๏ผไธๅจๆชๆฅไผๅ ้คใ
-
-ไธป้ขไผๆฃๆตๆฏๅฆไฝฟ็จๆง็่ฏญๆณ๏ผๅฆๆไฝฟ็จ๏ผไผๅจๆงๅถๅฐ่พๅบ่ญฆๅไฟกๆฏๅไฟฎๆนๅปบ่ฎฎ๏ผ่ฏทๆ นๆฎไฟฎๆนๅปบ่ฎฎ่ฟ่ก่ฐๆดใ
-
-:::
-
## ๆฆ่ฟฐ
ไธป้ขๆฏๆๅจ Markdown ๆไปถไธญไปฅไธๆฅๆบ็ๅพๆ ๏ผ
diff --git a/docs/guide/markdown/math.md b/docs/guide/markdown/math.md
new file mode 100644
index 00000000..47ec7e48
--- /dev/null
+++ b/docs/guide/markdown/math.md
@@ -0,0 +1,147 @@
+---
+title: ๆฐๅญฆๅ
ฌๅผ
+icon: tabler:math
+createTime: 2025/11/29 21:36:22
+permalink: /guide/markdown/math/
+---
+
+## ๆฆ่ฟฐ
+
+ไธป้ขๅ
็ฝฎไบๅฏน ๆฐๅญฆๅ
ฌๅผ ็ๆฏๆใ
+
+่ฏฅๅ่ฝ็ฑ [@vuepress/plugin-markdown-math](https://ecosystem.vuejs.press/zh/plugins/markdown/markdown-math.html) ๆไพๆฏๆใไฝ ๅฏไปฅ้ๆฉๅจ markdown ไธญไฝฟ็จไปฅไธๆนๅผๆธฒๆๆฐๅญฆๅ
ฌๅผ:
+
+- `katex` (้ป่ฎค)
+- `mathjax`
+
+## ไฝฟ็จ
+
+```ts title=".vuepress/config.ts"
+export default defineUserConfig({
+ theme: plumeTheme({
+ markdown: {
+ math: {
+ type: 'katex', // 'katex' | 'mathjax'
+ // ... ๅ
ถๅฎ้
็ฝฎ้กน
+ }
+ },
+ })
+})
+```
+
+ๅฝไฝ ้ๆฉไฝฟ็จ `mathjax` ๆถ๏ผ่ฟ้่ฆๆง่กไปฅไธๅฝไปคๅฎ่ฃ
ไพ่ต๏ผ
+
+::: npm-to
+
+```sh
+npm i @mathjax/src
+```
+
+:::
+
+## ่ฏญๆณ
+
+### ๅ
่่ฏญๆณ
+
+ไฝฟ็จ `$` ๅ
่ฃนๆฐๅญฆๅ
ฌๅผ _๏ผๅณๅจไธคไธช `$` ไน้ด็ผๅๆฐๅญฆๅ
ฌๅผ๏ผ_
+
+::: demo markdown title="ๅ
่ๆจกๅผ" expanded
+
+```md
+Euler's identity $e^{i\pi}+1=0$ is a beautiful formula in $\mathbb{R}^2$.
+```
+
+:::
+
+### ๅ็บง่ฏญๆณ
+
+ไฝฟ็จ `$$` ๅ
่ฃนๆฐๅญฆๅ
ฌๅผ _๏ผๅณๅจไธคไธช `$$` ไน้ด็ผๅๆฐๅญฆๅ
ฌๅผ๏ผ_
+
+```md /$$/
+
+$$xxx$$
+
+
+$$
+xxx
+$$
+```
+
+:::demo markdown title="ๅ็บงๆจกๅผ" expanded
+
+```md
+$$
+\frac {\partial^r} {\partial \omega^r} \left(\frac {y^{\omega}} {\omega}\right)
+= \left(\frac {y^{\omega}} {\omega}\right) \left\{(\log y)^r + \sum_{i=1}^r \frac {(-1)^ Ir \cdots (r-i+1) (\log y)^{ri}} {\omega^i} \right\}
+$$
+```
+
+:::
+
+## ็ธๅ
ณๆ็จ
+
+### TeX
+
+[TeX ๆ็จ](https://www.overleaf.com/learn/latex/Learn_LaTeX_in_30_minutes){.readmore}
+[TeX ้ๆฅ่กจ](https://mdit-plugins.github.io/zh/tex.html#tex-tutorial){.readmore}
+
+### KateX
+
+[KateX ๆฏๆๅ่ฝ](https://katex.org/docs/supported.html){.readmore}
+[KateX ๆฏๆๅ่กจ](https://katex.org/docs/support_table.html){.readmore}
+
+### Mathjax
+
+[ๆฏๆ็ TeX / KateX ๅฝไปค](https://docs.mathjax.org/en/latest/input/tex/macros/index.html#tex-commands){.readmore}
+
+## ้
็ฝฎ้กน
+
+:::: field-group
+::: field name="type" type="'katex' | 'mathjax'" default="'katex'"
+
+็จไบๆธฒๆ $\TeX$ ๅ
ๅฎน็ๅ
ใ
+
+- `'katex'`๏ผไฝฟ็จ [KaTeX](https://katex.org/)
+- `'mathjax'`๏ผไฝฟ็จ [MathJax](https://www.mathjax.org/)
+:::
+:::field name="delimiters" type="'brackets' | 'dollars' | 'all'" default="'dollars'" optional
+ๅฏ็จ็ๆฐๅญฆๅ้็ฌฆ่ฏญๆณใ
+ - `"brackets"`: ไฝฟ็จ `\(...\)` ่กจ็คบๅ
่ๆฐๅญฆ๏ผไฝฟ็จ `\[...\]` ่กจ็คบๆพ็คบๆจกๅผๆฐๅญฆ๏ผLaTeX ้ฃๆ ผ๏ผ
+ - `"dollars"`: ไฝฟ็จ `$...$` ่กจ็คบๅ
่ๆฐๅญฆ๏ผไฝฟ็จ `$$...$$` ่กจ็คบๆพ็คบๆจกๅผๆฐๅญฆ๏ผๅธธ่ง Markdown ้ฃๆ ผ๏ผ
+ - `"all"`: ๅฏ็จๆฌๅทๅ็พๅ
็ฌฆๅทไธค็ง่ฏญๆณ
+:::
+::::
+
+### ไฝฟ็จ KaTeX
+
+ไฝฟ็จ KaTeX ๆถ๏ผไปปไฝๅ
ถไป้้กน้ฝๅฐไฝไธบ `KatexOptions` ไผ ้็ป KaTeXใๆๅ
ณๆๆๅฏ็จ้้กน๏ผ่ฏทๅ้
[KaTeX ๆๆกฃ](https://katex.org/docs/options.html)ใ
+
+ๆญคๅค๏ผ่ฟๆฏๆ 2 ไธช็นๆฎ้้กน๏ผ
+
+:::: field-group
+::: field name="copy" type="boolean" optional default="false"
+ๆฏๅฆๅฏ็จๅคๅถๆฉๅฑใ
+:::
+::: field name="mhchem" type="boolean" optional default="false"
+ๆฏๅฆๅฏ็จ mhchem ๆฉๅฑใ
+:::
+::::
+
+### ไฝฟ็จ MathJax
+
+ไฝฟ็จ MathJax ๆถ๏ผไฝ ๅฏไปฅ่ฎพ็ฝฎ๏ผ
+
+:::: field-group
+:::field name="tex" type="object" optional
+ไผ ้็ป TeX ่พๅ
ฅ่งฃๆๅจ็้้กนใ
+:::
+::: field name="output" type="'svg' | 'chtml'" default="'svg'" optional
+่พๅบๆ ผๅผ๏ผSVG ๆ้็จ HTMLใ
+:::
+::: field name="chtml" type="object" optional
+ไผ ้็ป้็จ HTML ่พๅบ่งฃๆๅจ็้้กนใ
+:::
+::: field name="svg" type="object" optional
+ไผ ้็ป SVG ่พๅบ่งฃๆๅจ็้้กนใ
+:::
+::::
diff --git a/docs/guide/markdown/table.md b/docs/guide/markdown/table.md
index 0fb0fd6b..e0a9c7ff 100644
--- a/docs/guide/markdown/table.md
+++ b/docs/guide/markdown/table.md
@@ -287,6 +287,10 @@ export default defineUserConfig({
### ่กจๆ ผๅๅ
ๆ ผ้ซไบฎ
+#### ๆนๅผไธ
+
+ๅจ่กจๆ ผๅฎนๅจไธไฝฟ็จ `hl-cells="type:(row,col)"` ็ๆ ผๅผ๏ผๅฏไปฅไฝฟ็จ `;` ็ปๅๅคไธช type cellใ
+
**่พๅ
ฅ๏ผ**
```md
@@ -311,6 +315,34 @@ export default defineUserConfig({
:::
+#### ๆนๅผไบ
+
+ไฝฟ็จ [ๅฑๆงๆฏๆ](./attrs.md) ่ฏญๆณ
+
+**่พๅ
ฅ๏ผ**
+
+```md
+::: table title="่ฟๆฏ่กจๆ ผๆ ้ข"
+| (1,1) {.danger} | (1,2) | (1,3) | (1,4) {.warning} |
+| ------------------ | ------------------ | ---------------- | ----------------- |
+| (2,1) | (2,2) {.danger} | (2,3) {.warning} | (2,4) |
+| (3,1) | (3,2) {.important} | (3,3) {.danger} | (3,4) |
+| (4,1) {.important} | (4,2) | (4,3) | (4,4) {.danger} |
+:::
+```
+
+**่พๅบ๏ผ**
+
+::: table title="่ฟๆฏ่กจๆ ผๆ ้ข"
+
+| (1,1) {.danger} | (1,2) | (1,3) | (1,4) {.warning} |
+| ------------------ | ------------------ | ---------------- | ----------------- |
+| (2,1) | (2,2) {.danger} | (2,3) {.warning} | (2,4) |
+| (3,1) | (3,2) {.important} | (3,3) {.danger} | (3,4) |
+| (4,1) {.important} | (4,2) | (4,3) | (4,4) {.danger} |
+
+:::
+
## ่ชๅฎไน้ซไบฎ็ฑปๅ
ๅจ [่ชๅฎไน CSS ๆ ทๅผ](../custom/style.md) ไธญ๏ผ้่ฟไปฅไธๆ ผๅผๅฏไปฅ่ชๅฎไน้ซไบฎ็ฑปๅ๏ผ
@@ -360,3 +392,29 @@ export default defineUserConfig({
| Cell 4 | Cell 5 | Cell 6 |
:::
+
+## ่กจๆ ผๅๅ
ๆ ผๅๅนถ
+
+่กจๆ ผๅๅ
ๆ ผๅๅนถ็ฑ [markdown-it-attrs](https://github.com/arve0/markdown-it-attrs) ๅฑๆงๆฏๆ่ฏญๆณๆไพๅฎ็ฐใ
+ๅ ๆญคๅฎไธ้่ฆๅจ `:::table` ๅฎนๅจไธญไฝฟ็จ๏ผไฝ ๅฏไปฅๅจไฝไบบ่กจๆ ผไธญไฝฟ็จๅฎใ
+
+ๅจ่กจๆ ผๅๅ
ๆ ผๅ
๏ผๆซๅฐพ้จๅไฝฟ็จ ๅฑๆงๆฏๆ่ฏญๆณ `{}` ไธญ๏ผๆทปๅ `rowspan=rows` ๆ่
`{colspan=cols}` ๏ผๆ็ปๅไฝฟ็จ๏ผ
+ๅณๅฏๅฎ็ฐ่กจๆ ผๅๅ
ๆ ผๅๅนถใ
+
+**่พๅ
ฅ๏ผ**
+
+```md
+| A | B | C | D |
+| ----------------------- | --- | --- | ---------------- |
+| 1 | 11 | 111 | 1111 {rowspan=3} |
+| 2 {colspan=2 rowspan=2} | 22 | 222 | 2222 |
+| 3 | 33 | 333 | 3333 |
+```
+
+**่พๅบ๏ผ**
+
+| A | B | C | D |
+| ----------------------- | --- | --- | ---------------- |
+| 1 | 11 | 111 | 1111 {rowspan=3} |
+| 2 {colspan=2 rowspan=2} | 22 | 222 | 2222 |
+| 3 | 33 | 333 | 3333 |
diff --git a/docs/guide/quick-start/usage.md b/docs/guide/quick-start/usage.md
index 4575a214..0bb3609d 100644
--- a/docs/guide/quick-start/usage.md
+++ b/docs/guide/quick-start/usage.md
@@ -10,10 +10,10 @@ tags:
## ็ฏๅข่ฆๆฑ
-- [Node.js](https://nodejs.org/)๏ผ**^20.6.0 ๆ >= 22.0.0** [+node-versions]
+- [Node.js](https://nodejs.org/)๏ผ**^20.19.0 ๆ >= 22.0.0** [+node-versions]
- ๅ
็ฎก็ๅจ๏ผ[npm 8+](https://www.npmjs.com/)ใ[pnpm 8+](https://pnpm.io/zh/) ๆ [Yarn 2+](https://yarnpkg.com/)
-[+node-versions]: **^20.6.0๏ผ** `20.6.0` ๅไปฅไธไฝไฝไบ `21.0.0` ็็ๆฌ
+[+node-versions]: **^20.19.0๏ผ** `20.19.0` ๅไปฅไธไฝไฝไบ `21.0.0` ็็ๆฌ
[+node-versions]: **>= 22.0.0๏ผ** `22.0.0` ๅไปฅไธ็็ๆฌ
:::: details ๅฆไฝๅฎ่ฃ
็ฏๅขไพ่ต๏ผ