diff --git a/src/doc-entries/md-bg.md b/src/doc-entries/md-bg.md index 03abf12..b59dbc9 100644 --- a/src/doc-entries/md-bg.md +++ b/src/doc-entries/md-bg.md @@ -9,14 +9,16 @@ title: 背景组件 **语法:** `:md-bg[颜色或图片路径]{选项}` **设置背景图:** +```markdown :md-bg[./images/dungeon-bg.jpg]{fit="cover"} +``` **设置纯色背景:** +```markdown :md-bg[#2a1a3a] - :md-bg[rgb(200,50,50)] - :md-bg[#ff00dd] +``` 支持图片路径或任意 CSS 颜色值(hex、rgb、颜色名等)。 diff --git a/src/doc-entries/md-border.md b/src/doc-entries/md-border.md index 5bb9d4e..48eb7c7 100644 --- a/src/doc-entries/md-border.md +++ b/src/doc-entries/md-border.md @@ -9,16 +9,24 @@ title: 边框组件 **语法:** `:md-border[颜色或图片路径]{方位类 样式类 选项}` **纯色左边框:** +```markdown :md-border[#3b82f6]{.l} +``` **虚线上下边框:** +```markdown :md-border[red]{.t .b .dashed width=".2mm"} +``` **图片边框:** +```markdown :md-border[./images/frame.png]{.all .round} +``` **左右图片竖条:** +```markdown :md-border[./images/ornament.png]{.l .r .repeat} +``` ## 方位类 diff --git a/src/doc-entries/md-deck.md b/src/doc-entries/md-deck.md index b083bd0..5656020 100644 --- a/src/doc-entries/md-deck.md +++ b/src/doc-entries/md-deck.md @@ -9,10 +9,14 @@ title: 卡牌组件 **语法:** `:md-deck[./cards.csv]{选项}` 或 yaml 代码块 **基础卡牌:** +```markdown :md-deck[./spells.csv]{grid="3x3"} +``` **多层卡牌:** +```markdown :md-deck[./cards.csv]{grid="5x8" layers="title:1,1-5,1f8 body:1,5-8,8f3"} +``` CSV 包含数据字段列,通过图层定义控制各字段的位置、大小和对齐。 diff --git a/src/doc-entries/md-dice.md b/src/doc-entries/md-dice.md index 39d9300..f6ebca6 100644 --- a/src/doc-entries/md-dice.md +++ b/src/doc-entries/md-dice.md @@ -8,11 +8,20 @@ title: 骰子组件 **语法:** `:md-dice[公式]{key="标识"}` -**攻击检定:** :md-dice[1d20+5]{key="attack"} +**攻击检定:** +```markdown +:md-dice[1d20+5]{key="attack"} +``` -**伤害掷骰:** :md-dice[2d6+3]{key="damage"} +**伤害掷骰:** +```markdown +:md-dice[2d6+3]{key="damage"} +``` -**优势检定:** :md-dice[2d20k1+5]{key="advantage"} +**优势检定:** +```markdown +:md-dice[2d20k1+5]{key="advantage"} +``` 点击 🎲 图标执行投掷,显示结果;点击文字重置为原始公式。 diff --git a/src/doc-entries/md-embed.md b/src/doc-entries/md-embed.md index df3b06a..a866f99 100644 --- a/src/doc-entries/md-embed.md +++ b/src/doc-entries/md-embed.md @@ -9,10 +9,14 @@ title: 嵌入组件 **语法:** `:md-embed[路径#章节]{选项}` **嵌入完整文档:** +```markdown :md-embed[./rules.md] +``` **嵌入指定章节:** +```markdown :md-embed[./rules.md#combat] +``` 嵌入后内容直接在当前位置显示,包括其中的表格、骰子等组件也会正常渲染。 diff --git a/src/doc-entries/md-font.md b/src/doc-entries/md-font.md index 298648e..9c873ba 100644 --- a/src/doc-entries/md-font.md +++ b/src/doc-entries/md-font.md @@ -9,18 +9,25 @@ title: 字体组件 **语法:** `:md-font[字体名]{选项}` **Google 字体:** +```markdown :md-font[Noto Sans SC]{source="google"} +``` **Emfont 字体:** +```markdown :md-font[Source Han Serif]{source="emfont" weight="700"} +``` **本地字体(默认):** +```markdown :md-font[STSong] +``` **设置文字颜色:** +```markdown :md-font[Noto Sans SC]{source="google" color="#1a1a2e"} - :md-font[Noto Sans SC]{source="google" weight="700" color="crimson"} +``` 字体和颜色将应用到整个文档卡片。 diff --git a/src/doc-entries/md-link.md b/src/doc-entries/md-link.md index f7277a5..35bb853 100644 --- a/src/doc-entries/md-link.md +++ b/src/doc-entries/md-link.md @@ -9,10 +9,14 @@ title: 链接组件 **语法:** `:md-link[路径#章节]` **展开完整文档:** +```markdown :md-link[./rules.md] +``` **展开特定章节:** +```markdown :md-link[./rules.md#combat] +``` 点击链接即可内联展开目标内容,再次点击折叠。 diff --git a/src/doc-entries/md-pins.md b/src/doc-entries/md-pins.md index 5fb7c81..e87ec23 100644 --- a/src/doc-entries/md-pins.md +++ b/src/doc-entries/md-pins.md @@ -9,13 +9,19 @@ title: 标记组件 **语法:** `:md-pins[图片路径]{选项}` **固定标记(只读):** +```markdown :md-pins[./images/battle-map.png]{pins="A:25,50 B:75,30" fixed} +``` **可编辑标记:** +```markdown :md-pins[./images/blank-map.png] +``` **数字标签:** +```markdown :md-pins[./images/dungeon.png]{labelStart="1"} +``` 非 `fixed` 模式下点击图片添加标记,点击标记删除。 diff --git a/src/doc-entries/md-yarn-spinner.md b/src/doc-entries/md-yarn-spinner.md index 1da2024..047747e 100644 --- a/src/doc-entries/md-yarn-spinner.md +++ b/src/doc-entries/md-yarn-spinner.md @@ -9,7 +9,9 @@ title: 叙事线组件 **语法:** `:md-yarn-spinner[./story.yarn]{选项}` **加载叙事文件:** +```markdown :md-yarn-spinner[./story.yarn] +``` Yarn Spinner 是用于游戏对话系统的格式,支持选项、条件分支和变量。