MDX module for Nuxt.js
Last updated 2 months ago by codebender828 .
MIT · Original npm · Tarball · package.json
$ cnpm install @nuxtjs/mdx 
SYNC missed versions from official npm registry.



npm version npm downloads Github Actions CI Codecov License

MDX module for Nuxt


  • Import .mdx files as Vue components
  • Import Vue components in your .mdx files
  • Replace markdown elements with Vue components with the MDX Provider.

???? Release Notes


  1. Add @nuxtjs/mdx dependency to your project
yarn add --dev @nuxtjs/mdx # or npm install --dev @nuxtjs/mdx
  1. Add @nuxtjs/mdx to the buildModules section of nuxt.config.js
export default {
  buildModules: [


After installing the @nuxtjs/mdx module, you're ready to start using MDX files in your Nuxt app. The @nuxtjs/mdx module picks up all .mdx files used in your Nuxt app and converts them into Vue components. This makes it possible to use MDX files as Nuxt routes and regular components.

Using .mdx files in ~/pages directory

Start by creating a hello.mdx file in your ~/pages directory.


Inside hello.mdx, add some markdown content:

# Hello Nuxt MDX

    color: 'white',
    backgroundColor: 'tomato',
    padding: '3rem'
  This a Nuxt MDX tomato.

<nuxt-link to="/some/path">
  to some page &rarr;

After starting your app server, you can now view your rendered hello.mdx page at localhost:3000/hello ????

Importing .mdx files in Vue components

You can also import .mdx files as inside other Vue components.

    <!-- ???????? MDX file is parsed as Vue component -->
    <MyMDXComponent />

import MyMDXComponent from '~/components/MyMDXComponent.mdx'

export default {
  components: {


  1. Clone this repository
  2. Install dependencies using yarn
  3. Start development server using yarn dev


MIT License

Copyright (c) Jonathan Bakebwa codebender828@gmail.com

Contributors ✨

Thanks goes to these wonderful people (emoji key):

pooya parsa


Sébastien Chopin


Jonathan Bakebwa


This project follows the all-contributors specification. Contributions of any kind welcome!

Current Tags

  • 1.0.0                                ...           latest (2 months ago)

3 Versions

  • 1.0.0                                ...           2 months ago
  • 0.0.1                                ...           2 months ago
  • 0.0.0                                ...           2 months ago
Today 0
This Week 0
This Month 3
Last Day 0
Last Week 0
Last Month 1
Dependencies (2)
Dev Dependencies (15)
Dependents (0)

Copyright 2014 - 2016 © taobao.org |