Markdown feat. React loader

This package is deprecated. Use render-react-markdown-loader instead.

Loader, which not only converts markdown to the React, but can run javascript from code blocks.

Look at example: https://morulus.github.io/markdown-feat-react-loader

Look at example source: examples/simply/index.md

And try it: npm run example

Install loader:

npm install markdown-feat-react-loader --D

Usage

Configurate webpack loader:

rules: [
  {
    test: /\.md$/,
    exclude: /node_modules/,
    use: 'markdown-feat-react-loader'
  }
]

Usage in your markdown:

Loader enhances the markdown syntax. Like code lang extended property. Each time you use any of the next code chunks, you got render of the contained code.

• js{eval} To eval some script at the beginning of the document.

• js{render} To inline render React component from the code.

• js{+render} To display the code and render the code both

• js{render+} to render the code, and then display the code

Import markdown

As the result, you will get high-grade React Component.

import React from 'react';
import ReactDom from 'react-dom';
import Readme from './Readme.md';

ReactDom.render(
  <Readme />,
  document.getElementById('root')
)

As a normal React component, it can accept props.

<Readme version="v1.0.0" />

And markdown inline-components can use this props.

<Version>{props.version}</Version>

Advanced configuration

Loader uses react-markdown package to parse markdown at runtime. So it can be configurated in the same way as react-markdown.

Custom configuration must be passed to options as path to the .js file, which exports plain object.

{
  test: /\.md$/,
  exclude: /node_modules/,
  use: {
    loader: 'markdown-feat-react-loader',
    options: {
      config  : require.resolve(`./react-markdown.config.js`),
    },
  }
}

Example of react-markdown.config.js:

module.exports = {
  renderers: {
    code: MyCustomCodeComponent
  }
}

See react-markdown#node-types to read more abount renderers.

Load images via your bundler

Set option importImages to load images with your bundler loader.

{
  test: /\.md$/,
  exclude: /node_modules/,
  use: {
    loader : 'markdown-feat-react-loader',
    options: {
      importImages: true,
    },
  }
},
{
  test: /\.js$/,
  exclude: /node_modules/,
  use: 'babel-loader',
},
{
  test: /\.(png|jpg)$/,
  exclude: /node_modules/,
  use: 'file-loader'
}

Render HOC

Also you can specify the render HOC, which accepts component, which has been extracted from markdown code, and returns new component, which contain your custom logic.

For example, you can use it to pass props to the component, or with recompose, or in some another way.

import { withProps } from 'recompose';

module.exports = {
  renderers: {
    render: withProps({
      version: 'v0.3.1'
    })
  }
}

AST walker

Specify walkAst configuration property, to walk source AST, before loader will walk and render.

walkAst accepts ast and meta. The meta is an object that will be placed as a static property of the the exports.

Look at example, which extracts document title and puts it to the meta:

{
  test: /\.md$/,
  exclude: /node_modules/,
  use: {
    loader: 'markdown-feat-react-loader',
    options: {
      walkAst: (ast, meta) => {
        // Search for heading
        const headingKey = ast.children.findIndex(item => {
          if (item.type === `heading` && item.depth === 1) {
            return true;
          }
        });

        if (headingKey >= 0) {
          // Place heading to the meta
          meta.heading = ast.children[headingKey].children[0]
            && ast.children[headingKey].children[0].value;
          ast.children.splice(headingKey, 1)
        } else {
          // Place default heading
          meta.heading = false;
        }

        return ast;
      }
    }
  }
}

Usage:

import Article from 'article.md'

export default() {
  return (
    <div>
      <h1>{Article.meta.heading}</h1>
      <content>
        <Article />
      </content>
    </div>
  )
}

AST renderer

In super-advanced way you can add your custom logic to render AST to javascript. Also you can add some initial code to the evalChunks.

{
  test: /\.md$/,
  exclude: /node_modules/,
  use: {
    loader: 'markdown-feat-react-loader',
    options: {
      renderer: function(ast, evalChunks, defaultRenderer, meta) {
        // ast - Markdown ast

        // evalChunks - chunks of code, which will be injected to the top of javascript document
        evalChunks.push(`const lodash = require('lodash');`)

        return defaultRenderer(ast);
      },
    }
  }
}

You got the function defaultRenderer as the third argument, it provides you to render AST with the native logic, but you can manually convert AST to javascript code.

License

MIT, 2017 Vladimir Kalmykov