@shikijs/cli

Shiki in the command line.

Usage

The Shiki CLI works like cat command, but with syntax highlighting.

npx @shikijs/cli README.md

Install

You can also install it globally. Command aliases @shikijs/cli, shiki, skat are registered.

npm

npm i -g @shikijs/cli

yarn

yarn global add @shikijs/cli

pnpm

pnpm add -g @shikijs/cli

bun

bun add -g @shikijs/cli

skat src/index.ts

Options

--theme

Specify the theme to use. Defaults to vitesse-dark.

npx @shikijs/cli README.md --theme=nord

--lang

Language is auto-inferred from the file extension. You can override it with --lang.

npx @shikijs/cli src/index.js --lang=ts

Node.js API

The @shikijs/cli package also provides a Node.js API.

npm

npm i @shikijs/cli

yarn

yarn add @shikijs/cli

pnpm

pnpm add @shikijs/cli

bun

bun add @shikijs/cli

codeToANSI

The asynchronous codeToANSI function allows you to convert code to ANSI escape codes for terminal output. This is useful for rendering syntax-highlighted code in the terminal.

import { codeToANSI } from '@shikijs/cli'

const highlighted = await codeToANSI(source, 'typescript', 'nord')

console.log(highlighted)

codeToANSI takes three required parameters:

1. code: string
2. lang: BundledLanguage
3. theme: BundledTheme