@modern-js/mdx-rs-binding v0.2.8
@modern-js/mdx-rs-binding
This is a Node.js binding for MDX compliation of Modern.js Doc which is a modern documentation tool based on Rspack.
It can be 10x+ faster than compiler in pure JavaScript version.The benchmark result of @modern-js/mdx-rs-binding
vs @mdx-js/mdx
is as follows:
Tool | Time Spend |
---|---|
@modern-js/mdx-rs-binding | 163 ms |
@mdx-js/mdx | 3288 ms |
We forked mdxjs-rs, the Rust version of mdx compiler and customize it for Modern.js Doc, adding the following features:
Crate | Description |
---|---|
mdx_rs_binding | 🔥 Add Node.js binding so that we can use it in Node.js. |
mdx_plugin_container | Implement container grammar like :::tip in @modern-js/remark-container. |
mdx_plugin_toc | Generate table of contents. |
mdx_plugin_frontmatter | Parse frontmatter and export it in the esm module. |
mdx_plugin_external_link | Add target="_blank" and rel="noopener noreferrer" to external link. |
mdx_plugin_header_anchor | Add anchor for every header. |
mdx_plugin_normalize_link | Normalize link to complete url base on current filepath. |
mdx_plugin_html | Serialize hast to html string |
slugger | Generate slug for header, port from github-slugger. |
Install
# npm
npm install @modern-js/mdx-rs-binding
# yarn
yarn add @modern-js/mdx-rs-binding
# pnpm
pnpm install @modern-js/mdx-rs-binding
Usage
import { compile } from "@modern-js/mdx-rs-binding";
async function main() {
const value = `
# Hello World
This is a demo of @modern-js/mdx-rs-binding
`;
const result = await compile({
// The mdx content
value,
// File path of the mdx file, the compiler will determine the different syntax(md/mdx) based on the file extension
filepath: "xxx.mdx",
// Whether to enable development mode, default is false
development: true,
// Current working directory, can be empty string
root: "",
});
console.log(result);
}
Of course, you can also the compileSync
function to compile mdx synchronously, which is not recommended because it will block the event loop and slow down the compile process.
import { compileSync } from "@modern-js/mdx-rs-binding";
function main() {
const value = `
# Hello World
This is a demo of @modern-js/mdx-rs-binding
`;
const result = compileSync({
// The mdx content
value,
// File path of the mdx file, can be empty string
filepath: "",
// Whether to enable development mode, default is false
development: true,
// Current working directory, can be empty string
root: "",
});
console.log(result);
}
Credits
Thanks to mdxjs-rs, the awesome Rust library authored by wooorm.
Also, thanks to napi-rs, authored by Brooooooklyn, which is a great solution to help us build Node.js binding for Rust.
8 months ago
8 months ago
8 months ago
10 months ago
9 months ago
10 months ago
11 months ago
12 months ago
12 months ago
12 months ago
11 months ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago