@readme/markdown

ReadMe's flavored Markdown parser and MDX rendering engine.

npm install --save @readme/markdown

Usage

By default, the updated markdown package exports a function which takes a string of ReadMe-flavored markdown and returns a tree of React components:

import React from 'react';
import rdmd from "@readme/markdown";

export default ({ body }) => (
  <div className="markdown-body">
    {rdmd(body)}
  </div>
);

Export Methods

In addition to the default React processor, the package exports some other methods for transforming ReadMe-flavored markdown:

Export	Description	Arguments
react	(default) returns a VDOM tree object	text, options
md	transform mdast in to ReadMe-flavored markdown	tree, options
html	transform markdown in to HTML	text, options
mdast	transform markdown to an mdast object	text, options
hast	transform markdown to HAST object	text, options
plain	transform markdown to plain text	text, options
utils	contexts, defaults, helpers, etc.	N/A

Settings & Options

Each processor method takes an options object which you can use to adjust the output HTML or React tree. These options include:

• correctnewlines—render new line delimeters as <br> tags.
• markdownOptions—Remark parser options.
• compatibilityMode—enable compatibility features from our old markdown engine.

Flavored Syntax

Our old editor rendered "Magic Block" components from a custom, JSON-based syntax. To provide seamless backwards-compatibility, our new processor ships with built in support for parsing this old format, and transpiles it straight in to our new, flavored Markdown.

We've also sprinkled a bit of our own syntactic sugar on top to let you supercharge your docs. Learn more about ReadMe's flavored syntax!

Credits

• Lisence: MIT
• Authors: Dom Harrington, Rafe Goldberg