# Shiki

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

- Site: https://maplen.top/
- Page: https://maplen.top/wiki/shiki/
- LLM: https://maplen.top/wiki/shiki/llms.txt
- Author: 红枫 (Maple)
- Audience: AI agents / LLM tools
- Updated: 2026.11.09
- Markdown: https://maplen.top/wiki/shiki.md

## Content

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)

## Backlinks

- [脚本交互与代码展示：8 位微处理器动态演示](https://maplen.top/nodes/computer-showcase/llms.txt): 基于网站的 JS 脚本组件支持，构建 8 位 CPU 状态机可视化演示，并测试代码高亮、复制与悬停黑块功能
- [笔墨与纸面：Maplen 的排版美学与文本地基](https://maplen.top/nodes/markdown-showcase/llms.txt): 从字形微调、行间呼吸到 Wiki 双向链接与微观句子锚点，为长篇沉浸阅读筑牢坚实的地基
- [架构图与系统流向：Maplen 是如何运转的](https://maplen.top/nodes/architecture-showcase/llms.txt): 从 4N 正交体系到静态优先流水线，用 Mermaid 图表全景解析我为 Maplen 搭建的底层逻辑