VitePress Integration
VitePress uses Shikiji under the hood, so you don't need explicit integration.
VitePress provides a few options for customizing Shikiji. Learn more about them in the VitePress documentation.
Twoslash
To enable TypeScript Twoslash (type hover on code snippets) in VitePress, we provide a VitePress plugin for easy setup. Pre-styled, with Floating Vue to display the type information out side of the code container.
Setup
npm i -D vitepress-plugin-twoslash
In your .vitepress/config.ts
:
// .vitepress/config.ts
import { defineConfig } from 'vitepress'
import { transformerTwoslash } from 'vitepress-plugin-twoslash'
export default defineConfig({
markdown: {
codeTransformers: [
transformerTwoslash()
]
}
})
And then in your .vitepress/theme/index.ts
, install the Vue plugin and import the css with vitepress-plugin-twoslash/styles.css
.
// .vitepress/theme/index.ts
import Theme from 'vitepress/theme'
import TwoslashFloatingVue from 'vitepress-plugin-twoslash/client'
import 'vitepress-plugin-twoslash/style.css'
import type { EnhanceAppContext } from 'vitepress'
export default {
extends: Theme,
enhanceApp({ app }: EnhanceAppContext) {
app.use(TwoslashFloatingVue)
},
}
About style.css
For easier setup, vitepress-plugin-twoslash/styles.css
bundles the styles from floating-vue
and shikiji-twoslash/style-rich.css
so you only need a single entry. If you are using a custom floating-vue
style or want to have more control of the styles, you can expand them as:
import 'vitepress-plugin-twoslash/style.css'
// Equivalent to:
import 'shikiji-twoslash/style-rich.css'
import 'floating-vue/dist/style.css'
import 'vitepress-plugin-twoslash/style-core.css'
That's it, you can now use ts twoslash
in your markdown files to enable the beautiful type hover.
```ts twoslash
console.log('hello')
// ^?
```
It will be rendered as:
console.log('hello')
Vue Single File Component
In addition, this plugin also integrated twoslash-vue
for you, so that you can also highlight Vue SFC blocks with vue twoslash
:
<script setup>
import { onMounted, ref } from 'vue'
// reactive state
const count = ref(0)
// functions that mutate state and trigger updates
function increment() {
count.value++
}
// lifecycle hooks
onMounted(() => {
console.log(`The initial count is ${count.value}.`)
})
</script>
<template>
<button @click="increment">
Count is: {{ count }}
</button>
</template>