docs: update

This commit is contained in:
2026-03-26 11:24:28 +08:00
parent 228327913e
commit faf179a4fd
4 changed files with 85 additions and 5 deletions
+69 -1
View File
@@ -27,7 +27,7 @@
| `[content]` | 内容参数 | `[2d6+d8]` |
| `{attrs}` | 属性对象 | `{key="attack"}` |
### 嵌套指令
支持多个嵌套指令
```markdown
::: container
@@ -36,6 +36,40 @@
:::
```
## 分栏布局
使用简单的分隔符语法创建多栏布局:
```markdown
|---
左侧栏内容
-|-
右侧栏内容
---
```
**语法说明:**
| 分隔符 | 说明 |
|--------|------|
| `\|---` | 开始分栏容器 |
| `-|-` | 分隔各栏 |
| `---` | 结束分栏容器 |
**多栏示例:**
```markdown
|---
第一栏
-|-
第二栏
-|--
第三栏(更宽)
---
```
`-|--` 中的额外 `-` 会添加 `-N` 后缀到 CSS 类名(如 `col-2`),可用于自定义宽度。
## 图标语法
使用简单的 `:[icon-name]` 语法插入图标:
@@ -273,6 +307,27 @@ label,name,description
:md-table[./quests.csv]{roll=true remix=true}
```
**自动表格转换:**
标准 Markdown 表格会自动转换为 `md-table` 组件,当表头包含 `label``md-table-label` 列时:
```markdown
| label | name | description |
|-------|------|-------------|
| 1 | 战士 | 近战专家 |
| 2 | 法师 | 奥术施法者 |
```
自动转换为 `:md-table` 组件。
**特殊表头标识:**
| 表头 | 效果 |
|------|------|
| `label``md-table-label` | 转换为 md-table |
| `md-roll-label` 或骰子格式(如 `1d6` | 添加 `roll=true` |
| `md-remix-label` | 添加 `roll=true remix=true` |
### 🃏 卡牌组件 (md-deck)
```markdown
@@ -318,6 +373,19 @@ layers="字段:起始行,起始列 - 结束列,字体大小"
:md-token[./token.png]
```
### 🎨 代币预览组件 (md-token-viewer)
用于 3D 预览 3MF 格式的代币模型。
```markdown
:md-token-viewer[./token.3mf]
```
**功能:**
- 使用 Three.js 渲染 3D 模型
- 支持鼠标拖拽旋转
- 自动旋转展示
### 📋 命令追踪器 (md-commander)
支持命令历史和状态追踪。