@vuepress/markdown 2.0.0-beta.4 → 2.0.0-beta.42

package/lib/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/lib/markdown.d.ts

@@ -2,4 +2,4 @@ import type { Markdown, MarkdownOptions } from './types';
 /**
  * Create vuepress customized markdown-it instance
  */
-export declare const createMarkdown: ({ anchor, assets, code, customComponent, emoji, extractHeaders, hoistTags, links, toc, ...markdownItOptions }?: MarkdownOptions) => Markdown;
+export declare const createMarkdown: ({ anchor, assets, code, customComponent, emoji, extractHeaders, extractTitle, hoistTags, importCode, links, toc, ...markdownItOptions }?: MarkdownOptions) => Markdown;

package/lib/markdown.js

@@ -7,7 +7,7 @@ const utils_1 = require("./utils");
 /**
  * Create vuepress customized markdown-it instance
  */
-const createMarkdown = ({ anchor, assets, code, customComponent, emoji, extractHeaders, hoistTags, links, toc, ...markdownItOptions } = {}) => {
+const createMarkdown = ({ anchor, assets, code, customComponent, emoji, extractHeaders, extractTitle, hoistTags, importCode, links, toc, ...markdownItOptions } = {}) => {
     // create raw markdown-it instance
     const md = MarkdownIt({
         ...markdownItOptions,
@@ -17,7 +17,7 @@ const createMarkdown = ({ anchor, assets, code, customComponent, emoji, extractH
     // =====================================================
     // following plugins push rules to the end of chain, so
     // the order to use them is important
-    // parse emoji (before anchor and toc plugin)
+    // parse emoji
     if (emoji !== false) {
         md.use(plugins_1.emojiPlugin, emoji);
     }
@@ -26,13 +26,16 @@ const createMarkdown = ({ anchor, assets, code, customComponent, emoji, extractH
         md.use(plugins_1.anchorPlugin, {
             level: [1, 2, 3, 4, 5, 6],
             slugify: utils_1.slugify,
-            permalink: true,
-            permalinkBefore: true,
-            permalinkSymbol: '#',
+            permalink: plugins_1.anchorPlugin.permalink.ariaHidden({
+                class: 'header-anchor',
+                symbol: '#',
+                space: true,
+                placement: 'before',
+            }),
             ...anchor,
         });
     }
-    // allow toc syntax (after anchor plugin)
+    // allow toc syntax
     if (toc !== false) {
         md.use(plugins_1.tocPlugin, {
             level: [2, 3],
@@ -41,7 +44,7 @@ const createMarkdown = ({ anchor, assets, code, customComponent, emoji, extractH
             ...toc,
         });
     }
-    // extract headers into env (after anchor plugin)
+    // extract headers into env
     if (extractHeaders !== false) {
         md.use(plugins_1.extractHeadersPlugin, {
             level: [2, 3],
@@ -49,6 +52,10 @@ const createMarkdown = ({ anchor, assets, code, customComponent, emoji, extractH
             ...extractHeaders,
         });
     }
+    // extract title into env
+    if (extractTitle !== false) {
+        md.use(plugins_1.extractTitlePlugin);
+    }
     // =====================================================
     // following plugins modify or replace the rule in place
     // and have no conflicts, so the order is not important
@@ -72,6 +79,10 @@ const createMarkdown = ({ anchor, assets, code, customComponent, emoji, extractH
     if (code !== false) {
         md.use(plugins_1.codePlugin, code);
     }
+    // handle import_code syntax
+    if (importCode !== false) {
+        md.use(plugins_1.importCodePlugin, importCode);
+    }
     return md;
 };
 exports.createMarkdown = createMarkdown;

package/lib/plugins/anchorPlugin.d.ts

@@ -1,62 +1,3 @@
-import type { PluginWithOptions } from 'markdown-it';
-import State = require('markdown-it/lib/rules_core/state_core');
-import Token = require('markdown-it/lib/token');
-/**
- * Options for markdown-it-anchor
- *
- * @see https://github.com/valeriangalliat/markdown-it-anchor
- */
-export interface AnchorPluginOptions {
-    /**
-     * Minimum level to apply anchors on or array of selected levels
-     *
-     * @default 1
-     */
-    level?: number | number[];
-    /**
-     * A custom slugification function
-     */
-    slugify?: (str: string) => string;
-    /**
-     * Whether to add permalinks next to titles
-     *
-     * @default false
-     */
-    permalink?: boolean;
-    /**
-     * A custom permalink rendering function
-     */
-    renderPermalink?: (slug: string, opts: AnchorPluginOptions, state: State, tokenIndex: number) => void;
-    /**
-     * The class of the permalink anchor
-     */
-    permalinkClass?: string;
-    /**
-     * Place space between the header text and the permalink anchor
-     */
-    permalinkSpace?: boolean;
-    /**
-     * The symbol in the permalink anchor
-     */
-    permalinkSymbol?: string;
-    /**
-     * Place the permalink before the title
-     */
-    permalinkBefore?: boolean;
-    /**
-     * A custom permalink `href` rendering function
-     */
-    permalinkHref?: (slug: string, state: State) => string;
-    /**
-     * A custom permalink attributes rendering function
-     */
-    permalinkAttrs?: (slug: string, state: State) => Record<string, string>;
-    /**
-     * Called with token and info after rendering
-     */
-    callback?: (token: Token, opts: {
-        slug: string;
-        title: string;
-    }) => void;
-}
-export declare const anchorPlugin: PluginWithOptions<AnchorPluginOptions>;
+import anchorPlugin from 'markdown-it-anchor';
+export declare type AnchorPluginOptions = anchorPlugin.AnchorOptions;
+export { anchorPlugin };

package/lib/plugins/anchorPlugin.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.anchorPlugin = void 0;
-const rawAnchorPlugin = require("markdown-it-anchor");
-exports.anchorPlugin = rawAnchorPlugin;
+const markdown_it_anchor_1 = require("markdown-it-anchor");
+exports.anchorPlugin = markdown_it_anchor_1.default;

package/lib/plugins/assetsPlugin/assetsPlugin.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assetsPlugin = void 0;
+const resolveLink_1 = require("./resolveLink");
+/**
+ * Plugin to handle assets links
+ */
+const assetsPlugin = (md, { relativePathPrefix = '@source' } = {}) => {
+    // wrap raw image renderer rule
+    const rawImageRule = md.renderer.rules.image;
+    md.renderer.rules.image = (tokens, idx, options, env, self) => {
+        const token = tokens[idx];
+        // get the image link
+        const link = token.attrGet('src');
+        if (link) {
+            // replace the original link with resolved link
+            token.attrSet('src', (0, resolveLink_1.resolveLink)(link, relativePathPrefix, env));
+        }
+        return rawImageRule(tokens, idx, options, env, self);
+    };
+    // wrap raw html renderer rule
+    const createHtmlRule = (rawHtmlRule) => (tokens, idx, options, env, self) => {
+        // replace the original link with resolved link
+        tokens[idx].content = tokens[idx].content.replace(/(<img\b.*?src=")([^"]*)(")/gs, (_, prefix, link, suffix) => `${prefix}${(0, resolveLink_1.resolveLink)(link, relativePathPrefix, env)}${suffix}`);
+        return rawHtmlRule(tokens, idx, options, env, self);
+    };
+    const rawHtmlBlockRule = md.renderer.rules.html_block;
+    const rawHtmlInlineRule = md.renderer.rules.html_inline;
+    md.renderer.rules.html_block = createHtmlRule(rawHtmlBlockRule);
+    md.renderer.rules.html_inline = createHtmlRule(rawHtmlInlineRule);
+};
+exports.assetsPlugin = assetsPlugin;

package/lib/plugins/assetsPlugin/index.d.ts

@@ -0,0 +1,2 @@
+export * from './assetsPlugin';
+export * from './resolveLink';

package/lib/plugins/assetsPlugin/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./assetsPlugin"), exports);
+__exportStar(require("./resolveLink"), exports);

package/lib/plugins/assetsPlugin/resolveLink.d.ts

@@ -0,0 +1,2 @@
+import type { MarkdownEnv } from '../../types';
+export declare const resolveLink: (link: string, relativePathPrefix: string, env: MarkdownEnv) => string;

package/lib/plugins/assetsPlugin/resolveLink.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveLink = void 0;
+const utils_1 = require("@vuepress/utils");
+const mdurl_1 = require("mdurl");
+const resolveLink = (link, relativePathPrefix, env) => {
+    // decode link to ensure bundler can find the file correctly
+    let resolvedLink = (0, mdurl_1.decode)(link);
+    // if the link is relative path, and the `env.filePathRelative` exists
+    // add `@source` alias to the link
+    if (/^\.{1,2}\//.test(link) && env.filePathRelative) {
+        resolvedLink = `${relativePathPrefix}/${utils_1.path.join(utils_1.path.dirname(env.filePathRelative), resolvedLink)}`;
+    }
+    return resolvedLink;
+};
+exports.resolveLink = resolveLink;

package/lib/plugins/codePlugin/codePlugin.d.ts

@@ -6,8 +6,11 @@ export interface CodePluginOptions {
     highlightLines?: boolean;
     /**
      * Enable line numbers or not
+     *
+     * - A `boolean` value is to enable line numbers or not.
+     * - A `number` value is the minimum number of lines to enable line numbers
      */
-    lineNumbers?: boolean;
+    lineNumbers?: boolean | number;
     /**
      * Wrap the `<pre>` tag with an extra `<div>` or not. Do not disable it unless you
      * understand what's it for

package/lib/plugins/codePlugin/codePlugin.js

@@ -11,40 +11,39 @@ const resolveVPre_1 = require("./resolveVPre");
 const codePlugin = (md, { highlightLines = true, lineNumbers = true, preWrapper = true, vPre = true, } = {}) => {
     // override default fence renderer
     md.renderer.rules.fence = (tokens, idx, options, env, slf) => {
-        var _a, _b, _c;
         const token = tokens[idx];
         // get token info
         const info = token.info ? md.utils.unescapeAll(token.info).trim() : '';
-        // resolve highlight line ranges from token info
-        let highlightLinesRanges = null;
-        if (highlightLines) {
-            highlightLinesRanges = resolveHighlightLines_1.resolveHighlightLines(info);
-        }
-        // resolve line-numbers mark from token info
-        const useLineNumbers = (_a = resolveLineNumbers_1.resolveLineNumbers(info)) !== null && _a !== void 0 ? _a : lineNumbers;
-        // resolve v-pre mark from token info
-        const useVPre = (_b = resolveVPre_1.resolveVPre(info)) !== null && _b !== void 0 ? _b : vPre;
         // resolve language from token info
-        const language = resolveLanguage_1.resolveLanguage(info);
-        // the result of code and lang
-        let code = token.content;
-        // try to highlight code
-        code =
-            ((_c = options.highlight) === null || _c === void 0 ? void 0 : _c.call(options, code, language.name, '')) || md.utils.escapeHtml(code);
+        const language = (0, resolveLanguage_1.resolveLanguage)(info);
         const languageClass = `${options.langPrefix}${language.name}`;
-        let result = `<pre${useVPre ? ' v-pre' : ''} class="${languageClass}"><code>${code}</code></pre>`;
+        // try to get highlighted code
+        const code = options.highlight?.(token.content, language.name, '') ||
+            md.utils.escapeHtml(token.content);
+        // wrap highlighted code with `<pre>` and `<code>`
+        let result = code.startsWith('<pre')
+            ? code
+            : `<pre class="${languageClass}"><code>${code}</code></pre>`;
+        // resolve v-pre mark from token info
+        const useVPre = (0, resolveVPre_1.resolveVPre)(info) ?? vPre;
+        if (useVPre) {
+            result = `<pre v-pre${result.slice('<pre'.length)}`;
+        }
         // if `preWrapper` is disabled, return directly
         if (!preWrapper) {
             return result;
         }
         // code fences always have an ending `\n`, so we should trim the last line
         const lines = code.split('\n').slice(0, -1);
+        // resolve highlight line ranges from token info
+        const highlightLinesRanges = highlightLines
+            ? (0, resolveHighlightLines_1.resolveHighlightLines)(info)
+            : null;
         // generate highlight lines
         if (highlightLinesRanges) {
-            const ranges = highlightLinesRanges;
             const highlightLinesCode = lines
                 .map((_, index) => {
-                if (resolveHighlightLines_1.isHighlightLine(index + 1, ranges)) {
+                if ((0, resolveHighlightLines_1.isHighlightLine)(index + 1, highlightLinesRanges)) {
                     return '<div class="highlight-line">&nbsp;</div>';
                 }
                 return '<br>';
@@ -52,13 +51,18 @@ const codePlugin = (md, { highlightLines = true, lineNumbers = true, preWrapper
                 .join('');
             result = `${result}<div class="highlight-lines">${highlightLinesCode}</div>`;
         }
+        // resolve line-numbers mark from token info
+        const useLineNumbers = (0, resolveLineNumbers_1.resolveLineNumbers)(info) ??
+            (typeof lineNumbers === 'number'
+                ? lines.length >= lineNumbers
+                : lineNumbers);
         // generate line numbers
         if (useLineNumbers) {
             // generate line numbers code
             const lineNumbersCode = lines
                 .map((_, index) => `<span class="line-number">${index + 1}</span><br>`)
                 .join('');
-            result = `${result}<div class="line-numbers">${lineNumbersCode}</div>`;
+            result = `${result}<div class="line-numbers" aria-hidden="true">${lineNumbersCode}</div>`;
         }
         result = `<div class="${languageClass} ext-${language.ext}${useLineNumbers ? ' line-numbers-mode' : ''}">${result}</div>`;
         return result;

package/lib/plugins/codePlugin/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/lib/plugins/codePlugin/resolveLanguage.js

@@ -27,12 +27,11 @@ const getLanguagesMap = () => {
  * Resolve language for highlight from token info
  */
 const resolveLanguage = (info) => {
-    var _a, _b;
     // get user-defined language alias
-    const alias = ((_a = info.match(/^([a-zA-Z]+)/)) === null || _a === void 0 ? void 0 : _a[1]) || 'text';
+    const alias = info.match(/^([^ :[{]+)/)?.[1] || 'text';
     // if the alias does not have a match in the map
     // fallback to the alias itself
-    return ((_b = getLanguagesMap()[alias]) !== null && _b !== void 0 ? _b : {
+    return (getLanguagesMap()[alias] ?? {
         name: alias,
         ext: alias,
         aliases: [alias],

package/lib/plugins/customComponentPlugin/index.d.ts

@@ -1,4 +1,6 @@
 export * from './customComponentPlugin';
 export * from './htmlBlockRule';
+export * from './htmlInlineRule';
+export * from './htmlRe';
 export * from './inlineTags';
 export * from './vueReservedTags';

package/lib/plugins/customComponentPlugin/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -12,5 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./customComponentPlugin"), exports);
 __exportStar(require("./htmlBlockRule"), exports);
+__exportStar(require("./htmlInlineRule"), exports);
+__exportStar(require("./htmlRe"), exports);
 __exportStar(require("./inlineTags"), exports);
 __exportStar(require("./vueReservedTags"), exports);

package/lib/plugins/customComponentPlugin/vueReservedTags.d.ts

@@ -1,6 +1,6 @@
 /**
  * Vue reserved tags
  *
- * @see https://v3.vuejs.org/api/built-in-components.html
+ * @see https://vuejs.org/api/built-in-components.html
  */
 export declare const vueReservedTags: string[];

package/lib/plugins/customComponentPlugin/vueReservedTags.js

@@ -4,7 +4,7 @@ exports.vueReservedTags = void 0;
 /**
  * Vue reserved tags
  *
- * @see https://v3.vuejs.org/api/built-in-components.html
+ * @see https://vuejs.org/api/built-in-components.html
  */
 exports.vueReservedTags = [
     'template',

package/lib/plugins/extractHeadersPlugin.js

@@ -12,9 +12,10 @@ const extractHeadersPlugin = (md, { level = [2, 3], slugify = utils_1.slugify, f
     // push the rule to the end of the chain
     // resolve headers from the parsed tokens
     md.core.ruler.push('resolveExtractHeaders', (state) => {
-        headers = utils_1.resolveHeadersFromTokens(state.tokens, {
+        headers = (0, utils_1.resolveHeadersFromTokens)(state.tokens, {
             level,
             allowHtml: false,
+            escapeText: false,
             slugify,
             format,
         });
@@ -24,7 +25,7 @@ const extractHeadersPlugin = (md, { level = [2, 3], slugify = utils_1.slugify, f
     const render = md.render.bind(md);
     md.render = (src, env = {}) => {
         const result = render(src, env);
-        env.headers = headers !== null && headers !== void 0 ? headers : [];
+        env.headers = headers;
         return result;
     };
 };

package/lib/plugins/extractTitlePlugin.d.ts

@@ -0,0 +1,5 @@
+import type { PluginSimple } from 'markdown-it';
+/**
+ * Extracting markdown title to env
+ */
+export declare const extractTitlePlugin: PluginSimple;

package/lib/plugins/extractTitlePlugin.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTitlePlugin = void 0;
+const utils_1 = require("../utils");
+/**
+ * Extracting markdown title to env
+ */
+const extractTitlePlugin = (md) => {
+    let title;
+    // push the rule to the end of the chain
+    // resolve title from the parsed tokens
+    md.core.ruler.push('resolveExtractTitle', (state) => {
+        const tokenIdx = state.tokens.findIndex((token) => token.tag === 'h1');
+        if (tokenIdx > -1) {
+            title = (0, utils_1.resolveTitleFromToken)(state.tokens[tokenIdx + 1], {
+                escapeText: false,
+                allowHtml: false,
+            });
+        }
+        else {
+            title = '';
+        }
+        return true;
+    });
+    // extract title to env
+    const render = md.render.bind(md);
+    md.render = (src, env = {}) => {
+        const result = render(src, env);
+        env.title = env.frontmatter?.title ?? title;
+        return result;
+    };
+};
+exports.extractTitlePlugin = extractTitlePlugin;

package/lib/plugins/hoistTagsPlugin.js

@@ -12,7 +12,8 @@ const hoistTagsPlugin = (md, { customBlocks = [] } = {}) => {
     // hoist <script>, <style> and other user defined tags
     const hoistTags = Array.from(new Set(['script', 'style', ...customBlocks]));
     const hoistTagsRegexp = new RegExp(`^<(${hoistTags.join('|')})(?=(\\s|>|$))`, 'i');
-    md.renderer.rules.html_block = (tokens, idx, _, env) => {
+    const rawRule = md.renderer.rules.html_block;
+    md.renderer.rules.html_block = (tokens, idx, options, env, self) => {
         const content = tokens[idx].content;
         const hoistedTags = env.hoistedTags || (env.hoistedTags = []);
         // record the hoisted tags to env and do not render them
@@ -20,7 +21,7 @@ const hoistTagsPlugin = (md, { customBlocks = [] } = {}) => {
             hoistedTags.push(content);
             return '';
         }
-        return content;
+        return rawRule(tokens, idx, options, env, self);
     };
 };
 exports.hoistTagsPlugin = hoistTagsPlugin;

package/lib/plugins/importCodePlugin/createImportCodeBlockRule.d.ts

@@ -0,0 +1,3 @@
+import type { RuleBlock } from 'markdown-it/lib/parser_block';
+import type { ImportCodePluginOptions } from './importCodePlugin';
+export declare const createImportCodeBlockRule: ({ handleImportPath }: ImportCodePluginOptions) => RuleBlock;

package/lib/plugins/importCodePlugin/createImportCodeBlockRule.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createImportCodeBlockRule = void 0;
+const utils_1 = require("@vuepress/utils");
+// min length of the import code syntax, i.e. '@[code]()'
+const MIN_LENGTH = 9;
+// char codes of '@[code'
+const START_CODES = [64, 91, 99, 111, 100, 101];
+// regexp to match the import syntax
+const SYNTAX_RE = /^@\[code(?:{(?:(\d+)?-(\d+)?)})?(?: ([^\]]+))?\]\(([^)]*)\)/;
+const createImportCodeBlockRule = ({ handleImportPath = (str) => str }) => (state, startLine, endLine, silent) => {
+    // if it's indented more than 3 spaces, it should be a code block
+    /* istanbul ignore if */
+    if (state.sCount[startLine] - state.blkIndent >= 4) {
+        return false;
+    }
+    const pos = state.bMarks[startLine] + state.tShift[startLine];
+    const max = state.eMarks[startLine];
+    // return false if the length is shorter than min length
+    if (pos + MIN_LENGTH > max)
+        return false;
+    // check if it's matched the start
+    for (let i = 0; i < START_CODES.length; i += 1) {
+        if (state.src.charCodeAt(pos + i) !== START_CODES[i]) {
+            return false;
+        }
+    }
+    // check if it's matched the syntax
+    const match = state.src.slice(pos, max).match(SYNTAX_RE);
+    if (!match)
+        return false;
+    // return true as we have matched the syntax
+    if (silent)
+        return true;
+    const [, lineStart, lineEnd, info, importPath] = match;
+    const meta = {
+        importPath: handleImportPath(importPath),
+        lineStart: lineStart ? Number.parseInt(lineStart, 10) : 0,
+        lineEnd: lineEnd ? Number.parseInt(lineEnd, 10) : undefined,
+    };
+    // create a import_code token
+    const token = state.push('import_code', 'code', 0);
+    // use user specified info, or fallback to file ext
+    token.info = info ?? utils_1.path.extname(meta.importPath).slice(1);
+    token.markup = '```';
+    token.map = [startLine, startLine + 1];
+    // store token meta to be used in renderer rule
+    token.meta = meta;
+    state.line = startLine + 1;
+    return true;
+};
+exports.createImportCodeBlockRule = createImportCodeBlockRule;

package/lib/plugins/importCodePlugin/importCodePlugin.d.ts

@@ -0,0 +1,8 @@
+import type { PluginWithOptions } from 'markdown-it';
+export interface ImportCodePluginOptions {
+    /**
+     * A function to handle the import path
+     */
+    handleImportPath?: (str: string) => string;
+}
+export declare const importCodePlugin: PluginWithOptions<ImportCodePluginOptions>;

package/lib/plugins/importCodePlugin/importCodePlugin.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.importCodePlugin = void 0;
+const createImportCodeBlockRule_1 = require("./createImportCodeBlockRule");
+const resolveImportCode_1 = require("./resolveImportCode");
+const importCodePlugin = (md, options = {}) => {
+    // add import_code block rule
+    md.block.ruler.before('fence', 'import_code', (0, createImportCodeBlockRule_1.createImportCodeBlockRule)(options), {
+        alt: ['paragraph', 'reference', 'blockquote', 'list'],
+    });
+    // add import_code renderer rule
+    md.renderer.rules.import_code = (tokens, idx, options, env, slf) => {
+        const token = tokens[idx];
+        // use imported code as token content
+        const { importFilePath, importCode } = (0, resolveImportCode_1.resolveImportCode)(token.meta, env);
+        token.content = importCode;
+        // extract imported files to env
+        if (importFilePath) {
+            const importedFiles = env.importedFiles || (env.importedFiles = []);
+            importedFiles.push(importFilePath);
+        }
+        // render the import_code token as a fence token
+        return md.renderer.rules.fence(tokens, idx, options, env, slf);
+    };
+};
+exports.importCodePlugin = importCodePlugin;

package/lib/plugins/importCodePlugin/index.d.ts

@@ -0,0 +1,4 @@
+export * from './createImportCodeBlockRule';
+export * from './importCodePlugin';
+export * from './resolveImportCode';
+export * from './types';

package/lib/plugins/importCodePlugin/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./createImportCodeBlockRule"), exports);
+__exportStar(require("./importCodePlugin"), exports);
+__exportStar(require("./resolveImportCode"), exports);
+__exportStar(require("./types"), exports);

package/lib/plugins/importCodePlugin/resolveImportCode.d.ts

@@ -0,0 +1,6 @@
+import type { MarkdownEnv } from '../../types';
+import type { ImportCodeTokenMeta } from './types';
+export declare const resolveImportCode: ({ importPath, lineStart, lineEnd }: ImportCodeTokenMeta, { filePath }: MarkdownEnv) => {
+    importFilePath: string | null;
+    importCode: string;
+};