diff --git a/docs/plugins/markdown/shiki.md b/docs/plugins/markdown/shiki.md index 0dc2454397..904c6c29fb 100644 --- a/docs/plugins/markdown/shiki.md +++ b/docs/plugins/markdown/shiki.md @@ -46,6 +46,15 @@ export default { - Also see: - [Shiki > Languages](https://shiki.style/languages) +### langAlias + +- Type: `{ [lang: string]: string }` + +- Details: Customize language aliases for Shiki. + +- Also see: + - [Shiki > Custom Language Aliases](https://shiki.style/guide/load-lang#custom-language-aliases) + ### defaultLang - Type: `string` diff --git a/docs/zh/plugins/markdown/shiki.md b/docs/zh/plugins/markdown/shiki.md index eac603bdff..65f9398232 100644 --- a/docs/zh/plugins/markdown/shiki.md +++ b/docs/zh/plugins/markdown/shiki.md @@ -46,6 +46,15 @@ export default { - 参考: - [shiki > Languages](https://shiki.style/languages) +### langAlias + +- 类型:`{ [lang: string]: string }` + +- 详情:自定义 Shiki 语言别名。 + +- 参考: + - [Shiki > 自定义语言别名](https://shiki.tmrs.site/guide/load-lang#custom-language-aliases) + ### defaultLang - 类型:`string` diff --git a/plugins/markdown/plugin-shiki/src/node/resolveHighlight.ts b/plugins/markdown/plugin-shiki/src/node/resolveHighlight.ts index 9ae0b0ebe3..d9b9483984 100644 --- a/plugins/markdown/plugin-shiki/src/node/resolveHighlight.ts +++ b/plugins/markdown/plugin-shiki/src/node/resolveHighlight.ts @@ -12,6 +12,7 @@ const MUSTACHE_REG = /\{\{[^]*?\}\}/g export const resolveHighlight = async ({ langs = bundledLanguageNames, + langAlias = {}, theme = 'nord', themes, defaultLang = '', @@ -22,6 +23,7 @@ export const resolveHighlight = async ({ > => { const highlighter = await getHighlighter({ langs, + langAlias, themes: themes ? [themes.dark, themes.light] : [theme], }) diff --git a/plugins/markdown/plugin-shiki/src/node/types.ts b/plugins/markdown/plugin-shiki/src/node/types.ts index f3f6435cc6..3aa71001b8 100644 --- a/plugins/markdown/plugin-shiki/src/node/types.ts +++ b/plugins/markdown/plugin-shiki/src/node/types.ts @@ -31,6 +31,13 @@ export interface ShikiHighlightOptions { */ langs?: ShikiLang[] + /** + * Language alias + * + * @see https://shiki.style/guide/load-lang#custom-language-aliases + */ + langAlias?: Record> + /** * Fallback language when the specified language is not available. */