Shiki highlight to HTML: working versions (tested 2026-10-15)
Highlight TypeScript and JSON offline with Shiki's createHighlighter, producing HTML for a single theme and dual themes plus raw tokens, then dispose the highlighter.
passed4 passed · 0 failed2026-10-15 22:58 UTC- Status
- passed
- Last passed
- 2026-10-15 22:58 UTC
- Tests
- 4 / 4
- Language
- TypeScript
- Runtime
- node v22.23.3
pinned versions3
shiki@4.5.0@types/node@26.6.5tsx@4.23.15
run it
npm install --no-audit --no-fund --ignore-scripts=false npm test
test environment
node v22.23.3 linux 6.17.0-1022-azure x64 runner: github-actions 38820570375
The code
Exactly the files that passed. Your agent can pull them with get_recipe("shiki-highlight-html") (install), or see them on GitHub.
package.json
{
"name": "shiki-highlight-html",
"private": true,
"type": "module",
"scripts": {
"test": "node --import tsx --test test/*.test.ts"
},
"dependencies": {
"shiki": "4.5.0"
},
"devDependencies": {
"@types/node": "26.6.5",
"tsx": "4.23.15"
}
}
src/highlight.ts
import {
createHighlighter,
type BundledLanguage,
type BundledTheme,
type Highlighter,
} from "shiki";
export const THEMES: BundledTheme[] = ["github-light", "github-dark"];
export const LANGS: BundledLanguage[] = ["ts", "json"];
export function loadHighlighter(): Promise<Highlighter> {
return createHighlighter({ themes: THEMES, langs: LANGS });
}
test/highlight.test.ts
import { after, before, test } from "node:test";
import assert from "node:assert/strict";
import type { Highlighter } from "shiki";
import { loadHighlighter } from "../src/highlight.ts";
const tsCode = "const answer: number = 42;";
let highlighter: Highlighter;
before(async () => {
highlighter = await loadHighlighter();
});
after(() => {
highlighter.dispose();
});
test("codeToHtml renders a single theme", () => {
const html = highlighter.codeToHtml(tsCode, { lang: "ts", theme: "github-dark" });
assert.match(html, /^<pre class="shiki github-dark"/);
assert.ok(html.includes("<code>"));
assert.ok(html.includes("</code>"));
assert.ok(html.includes("</pre>"));
assert.ok(html.includes("<span style="));
assert.ok(html.includes(">const</span>"));
});
test("codeToHtml renders dual themes with dark CSS variables", () => {
const html = highlighter.codeToHtml(tsCode, {
lang: "ts",
themes: { light: "github-light", dark: "github-dark" },
});
assert.match(html, /^<pre class="shiki shiki-themes github-light github-dark"/);
assert.ok(html.includes("--shiki-dark"));
assert.ok(html.includes("--shiki-dark-bg"));
assert.ok(html.includes(">const</span>"));
});
test("codeToTokens exposes token content and colors", () => {
const result = highlighter.codeToTokens(tsCode, { lang: "ts", theme: "github-dark" });
assert.ok(result.tokens.length >= 1);
const joined = result.tokens
.map((line) => line.map((token) => token.content).join(""))
.join("\n");
assert.equal(joined, tsCode);
const keyword = result.tokens.flat().find((token) => token.content === "const");
assert.ok(keyword, "expected a const keyword token");
assert.match(keyword.color ?? "", /^#[0-9A-Fa-f]{6}$/);
});
test("codeToTokens highlights json strings", () => {
const json = '{ "name": "provenpin", "version": 1 }';
const result = highlighter.codeToTokens(json, { lang: "json", theme: "github-light" });
const tokens = result.tokens.flat();
assert.ok(tokens.some((token) => token.content.includes("provenpin")));
assert.ok(tokens.some((token) => token.content === "1"));
});
Connect to ProvenPin
Add the free MCP server so your agent can pull this recipe and others like it. Same setup as the docs.
terminal
claude mcp add --transport http provenpin https://mcp.provenpin.com/mcp
~/.cursor/mcp.json
{ "mcpServers": { "provenpin": { "url": "https://mcp.provenpin.com/mcp" } } }.vscode/mcp.json
{ "servers": { "provenpin": { "type": "http", "url": "https://mcp.provenpin.com/mcp" } } }~/.codeium/windsurf/mcp_config.json
{ "mcpServers": { "provenpin": { "serverUrl": "https://mcp.provenpin.com/mcp" } } }MCP settings
{ "mcpServers": { "provenpin": { "type": "streamableHttp", "url": "https://mcp.provenpin.com/mcp" } } }Any other MCP client: Streamable HTTP at https://mcp.provenpin.com/mcp. No API key, no signup.