# Shiki

> 基于 TextMate 语法的现代代码高亮引擎，为 Maplen 提供精准的双色主题代码块着色与复制工具

- HTML: /wiki/shiki/
- Markdown: /wiki/shiki.md
- Aliases: Shiki, 代码高亮, TextMate
- Updated: 2026.11.09

---

Shiki 是一套基于 VS Code 底层 TextMate 语法定义的高性能静态代码高亮引擎。

在 [Maplen](/wiki/maplen.md) 中，无论是汇编指令、TypeScript 核心逻辑，还是 Rust 系统底层代码，所有代码清单均由 Shiki 进行精准的语义着色。

## 为什么选择 Shiki

1. **绝对纯净的静态 HTML**：
   与 Prism.js 或 Highlight.js 等在浏览器端执行正则匹配的高亮库不同，Shiki 完全在 [Astro](/wiki/astro.md) 构建期运行。它直接生成带有内联颜色变量的 `<span>` 标签，浏览器端无需下载任何代码高亮脚本；
2. **VS Code 级语法精准度**：
   使用与现代集成开发环境完全一致的 TextMate 语法树解析，对复杂宏定义、泛型参数与汇编助记符拥有完美的色彩辨识度；
3. **双主题静态切换**：
   构建期同时注入针对「褐页（Light）」与「暖墨（Dark）」调校的配色方案，通过 CSS 变量平滑切换，避免色彩刺眼；
4. **原生增强工具**：
   配合 Maplen 的自定义 Markdown 插件，提供代码文件名标头（`title="..."`）、指定行聚焦高亮（`{4-7}`）与一键剪贴板复制按钮。

关于代码排版范例，可参考 [文字排版、代码语法与知识网络](/nodes/markdown-showcase.md)。

## 官方网站与参考链接

- **官方网站**：[Shiki 官方主页 (shiki.style)](https://shiki.style/)
- **扩展指南**：[Shiki Transformers 官方文档 (Diff / 高亮 / 聚焦)](https://shiki.style/guide/transformers)
- **开源仓库**：[GitHub - shikijs/shiki](https://github.com/shikijs/shiki)