1.0.5 • Published 6 months ago
mdx-to-md-x v1.0.5
mdx-to-md-x
Convert MDX to Markdown with enhanced image support.
Why?
This library is most useful for generating README.md files like the one you're reading.
Components Support
You can import and use React components in your MDX files in two ways:
- Using relative path:
import {MyComponent} from '../src/components/MyComponent'
- Using alias path (components will be resolved from src/components):
import {MyComponent} from 'components/MyComponent'
Install
yarn add mdx-to-md-x
npm install mdx-to-md-x
CLI
mdx-to-md [sourcePath] [outPath]
In the simplest use case, you can run the CLI and it will output the converted Markdown relative to the current working directory the script was run in:
yarn mdx-to-md README.mdx
Node
Start with MDX:
import { name, description } from "./package.json"
# {name}
{description}
# Install
<pre>
<code className="language-bash">yarn add {name}</code>
</pre>
And convert it to Markdown:
import { writeFile } from "fs/promises"
import { mdxToMd } from "mdx-to-md"
const markdown = await mdxToMd("README.mdx")
const banner = `This README was auto-generated using "yarn build:readme"`
const readme = `<!--- ${banner} --> \n\n ${markdown}`
await writeFile("README.md", readme)
console.log("📝 Converted README.mdx -> README.md")
Which outputs:
# mdx-to-md
Convert MDX to Markdown.
# Install
yarn add mdx-to-md