TwilightRain | 博客写作全部特性验收

博客写作全部特性验收

约 2251 字 · 阅读约 6 分钟

本文是 ink 写作能力的验收样文，并附带模板层能力（分享、相关文章、双链等）。

文内双链示例：[[关于我]]。

提示块（admonitions）

用 :::admon[类型] 包裹内容即可生成彩色提示块，类型有五种，各自有独立的颜色与图标：

Note

高亮读者需要留意的信息，即使只是扫读也该看到。

Tip

可选信息，帮助读者更顺利地使用。

Important

读者成功所需的关键信息。

Warning

需要立即注意的潜在风险内容。

Caution

某个操作可能带来的负面后果。

标题可以自定义：

提示块的标题可以自定义

默认标题显示类型名（Note / Tip 等），用 :::admon[类型 标题] 可以覆盖。块内支持完整的 Markdown：加粗、行内代码、列表与代码块。

Mermaid 图表

graph TD
    A[写文章] --> B{用了新语法?}
    B -->|是| C[渲染为图表]
    B -->|否| D[普通代码块高亮]
    C --> E[发布到 main 分支]
    D --> E
sequenceDiagram
    participant 作者
    participant 博客
    作者->>博客: 提交 Markdown
    博客->>博客: 构建与发布
    博客-->>读者: 渲染 HTML

阅读时间、公式与目录

文章页显示「约 N 字 · 阅读约 M 分钟」（构建期计算）。行内公式 $E=mc^2$，块级公式：

$$\int_0^1 x^2 , dx = \frac{1}{3}$$

长文自动生成目录卡（与头图并排）；标题 hover 显示 # 锚点。

通用链接卡片

关于本站twilightrain.com
个人介绍与站点说明

GitHub 仓库卡片

TwilightRainDev/TwilightRain
本博客源码仓库
hexojs/hexo
Hexo 博客框架

标签页 tabs

在 Markdown 里用 :::tabs 与 --- 标题 分隔子页。

点击按钮切换面板，默认激活第一个。

文内照片墙

图一 图二 图三

隐藏与折叠（推荐 :::fold）

悬停或点击查看剧透

这是 :::fold[text] 行内揭示块，适合短剧透或答案。

展开详细说明

:::fold[details] 是统一的块级折叠容器，支持 Markdown 与列表。

文内时间线（Butterfly 批一）

写作特性演进
Reimu 批一

段落锚点、懒加载、代码折叠、文章时效

Butterfly 批一

timeline / btn·label

Butterfly 批二

B 站嵌入

Butterfly 批三

站点卡、系列文

B 站懒嵌入（Butterfly 批二）

系列文目录

本篇 front matter 含 series: 写作特性验收，文内 ::series 会输出系列目录（当前仅一篇，作展示）。

代码块复制与超长折叠

下方为 45 行占位代码，应出现「展开全部」按钮且预览区可见正文开头（非空列对行号）。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// fold-demo line 01
// fold-demo line 02
// fold-demo line 03
// fold-demo line 04
// fold-demo line 05
// fold-demo line 06
// fold-demo line 07
// fold-demo line 08
// fold-demo line 09
// fold-demo line 10
// fold-demo line 11
// fold-demo line 12
// fold-demo line 13
// fold-demo line 14
// fold-demo line 15
// fold-demo line 16
// fold-demo line 17
// fold-demo line 18
// fold-demo line 19
// fold-demo line 20
// fold-demo line 21
// fold-demo line 22
// fold-demo line 23
// fold-demo line 24
// fold-demo line 25
// fold-demo line 26
// fold-demo line 27
// fold-demo line 28
// fold-demo line 29
// fold-demo line 30
// fold-demo line 31
// fold-demo line 32
// fold-demo line 33
// fold-demo line 34
// fold-demo line 35
// fold-demo line 36
// fold-demo line 37
// fold-demo line 38
// fold-demo line 39
// fold-demo line 40
// fold-demo line 41
// fold-demo line 42
// fold-demo line 43
// fold-demo line 44
// fold-demo line 45

模板层能力（无需正文语法）

Important

验收通过标准：上述块级语法均渲染为对应 DOM 类名；交互类（hide、tabs、代码折叠、B 站占位）可无控制台错误地响应点击/滚动。

评论