Overview

Importing code allows you to include code from another file in your markdown file and have it highlighted.

It helps you reference code from other files in your articles, avoiding duplicate code writing.

Syntax

You can use the following syntax to import code blocks from files:

Input:

@[code](../snippet/snippet-1.js)

Output:

export const a = 1

If you only want to import a specific portion of the file:

<!-- Import only lines 1 to 10 -->
@[code{1-10}](../snippet/snippet-1.js)

The code language is inferred from the file extension, but we recommend explicitly specifying it:

<!-- Specify code language -->
@[code js](../snippet/snippet-1.js)

<!-- Line highlighting -->
@[code js{2,4-5}](../foo.js)

Contributors

pengzhanbo

Changelog

10/9/25, 7:46 AM

View All Changelog

• 38505-docs: update en docs (#708)on 10/9/25