363 字
2 分钟
Markdown 步骤

当过程的先后顺序很重要时,请使用 Steps。该组件能保持文章的阅读流完整:一条低调的编号栏提供方位指引,而标题、段落、链接、列表与代码仍保留其原生的 Markdown 角色。

有序列表语法#

将一条 Markdown 有序列表包裹在 :::steps 容器中。每个顶层列表项即成为一个步骤。

:::steps[Production deployment]
1. **Clone and prepare the workspace**
Clone the repository and enter the project directory.
```powershell
git clone https://github.com/LyraVoid/Shirone.git
Set-Location Shirone
```
2. **Install dependencies**
Use the repository's pinned package manager.
```powershell
pnpm.cmd install
```
3. **Run project checks**
Confirm Astro diagnostics and TypeScript checks pass.
```powershell
npx.cmd astro check
pnpm.cmd type-check
```
4. **Build the production site**
Generate the static site and search index.
```powershell
pnpm.cmd build
```
:::

生产环境部署

  1. 克隆并准备工作区

    克隆仓库并进入项目目录。

    Terminal window
    git clone https://github.com/LyraVoid/Shirone.git
    Set-Location Shirone
  2. 安装依赖

    使用仓库锁定的包管理器。

    Terminal window
    pnpm.cmd install
  3. 运行项目检查

    确认 Astro 诊断与 TypeScript 检查均通过。

    Terminal window
    npx.cmd astro check
    pnpm.cmd type-check
  4. 构建生产站点

    生成静态站点与搜索索引。

    Terminal window
    pnpm.cmd build

选项#

  • :::steps[Title]title="Title" 可添加可见的标签与无障碍名称。
  • start=4 可修改首个显示的步骤编号。
  • 容器内必须恰好包含一个有序列表。无效或混合的输入会作为普通可读的 Markdown 保留,而不会被启发式地解读。
  • 渲染在站点构建期间完成,不会增加任何客户端 JavaScript 或网络请求。
Markdown 步骤
https://shirone.mysqil.com/posts/steps/
作者
Znfooe
发布于
2026-08-27
许可协议
CC BY-NC-SA 4.0

分享文章

生成精美分享图或复制链接,与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类

换条路线

从其他文章中稳定抽取