Skip to content
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
Latest commit bd8e53b Jan 17, 2022 History
1 contributor

Users who have contributed to this file

962 lines (649 sloc) 25.8 KB


All notable changes will be documented in this file.

8.0.0 - 2022-01-17

  • cd845c9 Remove deprecated plugins option
    (migrate by renaming it to remarkPlugins)
  • 36e4916 Update remark-rehype, add support for passing it options
    by @peolic in #669
    (migrate by removing remark-footnotes and updating remark-gfm if you were using them, otherwise you shouldn’t notice this)

7.1.2 - 2022-01-02

7.1.1 - 2021-11-29

7.1.0 - 2021-10-21

7.0.1 - 2021-08-26

  • ec387c2 Add improved type for linkTarget as string
  • 5af6bc7 Fix to correctly compile intrinsic types

7.0.0 - 2021-08-13

Welcome to version 7. This a major release and therefore contains breaking changes.

Breaking changes


6.0.3 - 2021-07-30

  • 13367ed Fix types to include each element w/ its properties
  • 0a1931a Fix to add min version of property-information

6.0.2 - 2021-05-06

  • cefc02d Add string type for classNames
  • 6355e45 Fix to pass vfile to plugins
  • 5cf6e1b Fix to add warning when non-strings are given as children

6.0.1 - 2021-04-23

  • 2e956be Fix whitespace in table elements
  • d36048a Add architecture section to readme

6.0.0 - 2021-04-15

Welcome to version 6. This a major release and therefore contains breaking changes.

Change renderers to components

react-markdown used to let you define components for markdown constructs (link, delete, break, etc). This proved complex as users didn’t know about those names or markdown peculiarities (such as that there are fully formed links and link references).

See GH-549 for more on why this changed. See Appendix B: Components in for more on components.

Show example of needed change

Before (broken):

    // Use a fancy hr
    thematicBreak: ({node, ...props}) => <MyFancyRule {...props} />

Now (fixed):

    // Use a fancy hr
    hr: ({node, ...props}) => <MyFancyRule {...props} />
Show conversion table
Type (renderers) Tag names (components)
blockquote blockquote
break br
code, inlineCode code, pre​*​
delete del
emphasis em
heading h1, h2, h3, h4, h5, h6§
html, parsedHtml, virtualHtml
image, imageReference img
link, linkReference a
list ol, ul
listItem li
paragraph p
root ​**​
strong strong
table table
tableHead thead
tableBody tbody
tableRow tr
tableCell td, th
thematicBreak hr
  • ​*​ It’s possible to differentiate between code based on the inline prop. Block code is also wrapped in a pre
  • Resource ([text](url)) and reference ([text][id]) style links and images (and their definitions) are now resolved and treated the same
  • Available when using remark-gfm
  • § It’s possible to differentiate between heading based on the level prop
  • When using rehype-raw (see below), components for those elements can also be used (for example, abbr for <abbr title="HyperText Markup Language">HTML</abbr>)
  • It’s possible to differentiate between lists based on the ordered prop
  • ​**​ Wrap ReactMarkdown in a component instead

Add rehypePlugins

We’ve added another plugin system: rehype. It’s similar to remark (what we’re using for markdown) but for HTML.

There are many rehype plugins. Some examples are @mapbox/rehype-prism (syntax highlighting with Prism), rehype-katex (rendering math with KaTeX), or rehype-autolink-headings (adding links to headings).

See List of plugins for more plugins.

Show example of feature
import rehypeHighlight from 'rehype-highlight'

<Markdown rehypePlugins={[rehypeHighlight]}>{`~~~js

Remove buggy HTML in markdown parser

In a lot of cases, you should not use HTML in markdown: it’s most always unsafe. And it defeats much of the purpose of this project (not relying on dangerouslySetInnerHTML).

react-markdown used to have an opt-in HTML parser with a bunch of bugs. As we now support rehype plugins, we can defer that work to a rehype plugin. To support HTML in markdown with react-markdown, use rehype-raw. The astPlugins and allowDangerousHtml (previously called escapeHtml) props are no longer needed and were removed.

When using rehype-raw, you should probably use rehype-sanitize too.

Show example of needed change

Before (broken):

import MarkdownWithHtml from 'react-markdown/with-html'

<MarkdownWithHtml>{`# Hello, <i>world</i>!`}</MarkdownWithHtml>

Now (fixed):

import Markdown from 'react-markdown'
import rehypeRaw from 'rehype-raw'
import rehypeSanitize from 'rehype-sanitize'

<Markdown rehypePlugins={[rehypeRaw, rehypeSanitize]}>{`# Hello, <i>world</i>!`}</Markdown>

Change source to children

Instead of passing a source pass children instead:

Show example of needed change

Before (broken):

<Markdown source="some\nmarkdown"></Markdown>

Now (fixed):


Or (also fixed):

<Markdown children={`some
markdown`} />

Replace allowNode, allowedTypes, and disallowedTypes

Similar to the renderers to components change, the filtering options also changed from being based on markdown names towards being based on HTML names: allowNode to allowElement, allowedTypes to allowedElements, and disallowedTypes to disallowedElements.

Show example of needed change

Before (broken):

  // Skip images
>{`![alt text](./image.url)`}</Markdown>

Now (fixed):

  // Skip images
>{`![alt text](./image.url)`}</Markdown>

Before (broken):

  // Skip h1
  allowNode={(node) => node.type !== 'heading' || node.depth !== 1}
>{`# main heading`}</Markdown>

Now (fixed):

  // Skip h1
  allowElement={(element) => element.tagName !== 'h1'}
>{`# main heading`}</Markdown>

Change includeNodeIndex to includeElementIndex

Similar to the renderers to components change, this option to pass more info to components also changed from being based on markdown to being based on HTML.

Show example of needed change

Before (broken):

    paragraph({node, index, parentChildCount, ...props}) => <MyFancyParagraph {...props} />
>{`Some text`}</Markdown>

Now (fixed):

    p({node, index, siblingsCount, ...props}) => <MyFancyParagraph {...props} />
>{`Some text`}</Markdown>

Change signature of transformLinkUri, linkTarget

The second parameter of these functions (to rewrite href on a or to define target on a) are now hast (HTML AST) instead of mdast (markdown AST).

Change signature of transformImageUri

The second parameter of this function was always undefined and the fourth was the alt (string) on the image. The second parameter is now that alt.

Remove support for React 15, IE11

We now use ES2015 (such as Object.assign) and removed certain hacks to work with React 15 and older.

5.0.3 - 2020-10-23

  • bb0bdde Unlock peer dependency on React to allow v17
  • 24e42bd Fix exception on missing element from html-to-react
  • 3d363e9 Fix umd browser build

5.0.2 - 2020-10-23

  • 4dadaba Fix to allow combining allowedTypes, unwrapDisallowed in types

5.0.1 - 2020-10-21

  • c3dc5ee Fix to not crash on empty text nodes

5.0.0 - 2020-10-19


Maintained by unified

This project is now maintained by the unified collective, which also houses the underlying tools used in react-markdown: hundreds of projects for working with markdown and markup related things (including MDX). We have cleaned the project: updated dependencies, improved docs/tests/coverage/types, cleaned the issue tracker, and fixed a couple of bugs, but otherwise much should be the same.

Upgrade remark-parse

The parser used in react-markdown has been upgraded to the latest version. It is now 100% CommonMark compliant: that means it works the same as in other places, such as Discourse, Reddit, Stack Overflow, and GitHub. Note that GitHub does extend CommonMark: to match how Markdown works on GitHub, use the remark-gfm plugin.

New serializer property: node

A new node prop is passed to all non-tag/non-fragment renderers. This contains the raw mdast AST node, which opens up a number of interesting possibilities. The breaking change is for renderers which blindly spread their props to an underlying component/tag. For instance:

<ReactMarkdown renderers={{link: props => <a {...props} />}}  />

Should now be written as:

<ReactMarkdown renderers={{link: ({node, ...props}) => <a {...props} />}}  />

List/list item tight property replaced by spread

Previously, the tight property would hint as to whether or not list items should be wrapped in paragraphs. This logic has now been replaced by a new spread property, which behaves slightly differently. Read more.

4.3.1 - 2020-01-05


  • (Typings) Fix incorrect typescript definitions (Peng Guanwen)

4.3.0 - 2020-01-02


  • (Typings) Add typings for react-markdown/html-parser (Peng Guanwen)

4.2.2 - 2019-09-03


  • (Typings) Inline RemarkParseOptions for now (Espen Hovlandsdal)

4.2.1 - 2019-09-01


  • (Typings) Fix incorrect import - RemarkParseOptions (Jakub Chrzanowski)

4.2.0 - 2019-09-01


  • Add support for plugins that use AST transformations (Frankie Ali)


  • (Typings) Add parserOptions to type defintions (Ted Piotrowski)
  • Allow renderer to be any React element type (Nathan Bierema)

4.1.0 - 2019-06-24


  • Add prop parserOptions to specify options for remark-parse (Kelvin Chan)

4.0.9 - 2019-06-22


  • (Typings) Make transformLinkUri & transformImageUri actually nullable (Florentin Luca Rieger)

4.0.8 - 2019-04-14


  • Fix HTML parsing of elements with a single child vs. multiple children (Nicolas Venegas)

4.0.7 - 2019-04-14


  • Fix matching of replaced non-void elements in HTML parser plugin (Nicolas Venegas)
  • Fix HTML parsing of multiple void elements (Nicolas Venegas)
  • Fix void element children invariant violation (Nicolas Venegas)

4.0.6 - 2019-01-04


  • Mitigate regex ddos by upgrading html-to-react (Christoph Werner)
  • Update typings to allow arbitrary node types (Jesse Pinho)
  • Readme: Add note about only parsing plugins working (Vincent Tunru)

4.0.4 - 2018-11-30


  • Upgrade dependencies (Espen Hovlandsdal)

4.0.3 - 2018-10-11


  • Output paragraph element for last item in loose list (Jeremy Moseley)

4.0.2 - 2018-10-05


  • Fix text rendering in React versions lower than or equal to 15 (Espen Hovlandsdal)

4.0.1 - 2018-10-03


  • [TypeScript] Fix TypeScript index signature for renderers (Linus Unnebäck)

4.0.0 - 2018-10-03


  • text is now a first-class node + renderer — if you are using allowedNodes, it needs to be included in this list. Since it is now a React component, it will be passed an object of props instead of the old approach where a string was passed. children will contain the actual text string.
  • On React >= 16.2, if no className prop is provided, a fragment will be used instead of a div. To always render a div, pass 'div' as the root renderer.
  • On React >= 16.2, escaped HTML will no longer be rendered with div/span containers
  • The UMD bundle now exports the component as window.ReactMarkdown instead of window.reactMarkdown


  • HTML parser plugin for full HTML compatibility (Espen Hovlandsdal)


  • URI transformer allows uppercase http/https URLs (Liam Kennedy)
  • [TypeScript] Strongly type the keys of renderers (Linus Unnebäck)

3.6.0 - 2018-09-05


  • Add support for passing index info to renderers (Beau Roberts)

3.5.0 - 2018-09-03


  • Allow specifying target attribute for links (Marshall Smith)

3.4.1 - 2018-07-25


  • Bump dependency for mdast-add-list-metadata as it was using ES6 features (Espen Hovlandsdal)

3.4.0 - 2018-07-25


  • Add more metadata props to list and listItem (André Staltz)
    • list: depth
    • listItem: ordered, index


  • Make source property optional in typescript definition (gRoberts84)

3.3.4 - 2018-06-19


  • Fix bug where rendering empty link references ([][]) would fail (Dennis S)

3.3.3 - 2018-06-14


  • Fix bug where unwrapping certain disallowed nodes would fail (Petr Gazarov)

3.3.2 - 2018-05-07


  • Add rawSourcePos property for passing structured source position info to renderers (Espen Hovlandsdal)

3.3.1 - 2018-05-07


  • Pass properties of unknown nodes directly to renderer (Jesse Pinho)
  • Update TypeScript definition and prop types (ClassicDarkChocolate)

3.3.0 - 2018-03-06


  • Add support for fragment renderers (Benjamim Sonntag)

3.2.2 - 2018-02-26


  • Fix language escaping in code blocks (Espen Hovlandsdal)

3.2.1 - 2018-02-21


  • Pass the React key into an overridden text renderer (vanchagreen)

3.2.0 - 2018-02-12


  • Allow overriding text renderer (Thibaud Courtoison)

3.1.5 - 2018-02-03


  • Only use first language from code block (Espen Hovlandsdal)

3.1.4 - 2017-12-30


  • Enable transformImageUri for image references (evoye)

3.1.3 - 2017-12-16


  • Exclude babel config from npm package (Espen Hovlandsdal)

3.1.2 - 2017-12-16


  • Fixed partial table exception (Alexander Wong)

3.1.1 - 2017-12-11


  • Add readOnly property to checkboxes (Phil Rajchgot)

3.1.0 - 2017-11-30


  • Support for checkbox lists (Espen Hovlandsdal)


  • Better typings (Igor Kamyshev)

3.0.1 - 2017-11-21


  • Experimental support for plugins (Espen Hovlandsdal)


  • Provide more arguments to transformLinkUri/transformImageUri (children, title, alt) (mudrz)

3.0.0 - 2017-11-20


  • FULL REWRITE. Changed parser from CommonMark to Markdown. Big, breaking changes. See BREAKING below.


  • Table support!
    • New types: table, tableHead, tableBody, tableRow, tableCell
  • New type: delete (~~foo~~)
  • New type: imageReference
  • New type: linkReference
  • New type: definition
  • Hacky, but basic support for React-native rendering of attributeless HTML nodes (<kbd>, <sub>, etc)


  • Container props removed (containerTagName, containerProps), override root renderer instead
  • softBreak option removed. New solution will be added at some point in the future.
  • escapeHtml is now TRUE by default
  • HtmlInline/HtmlBlock are now named html (use isBlock prop to check
    if inline or block)
  • Renderer names are camelcased and in certain cases, renamed. For instance:
    • Emph => emphasis
    • Item => listItem
    • Code => inlineCode
    • CodeBlock => code
    • linebreak/hardbreak => break
  • All renderers: literal prop is now called value* List renderer: type prop is now a boolean named ordered (Bullet => false, Ordered => true)
  • walker prop removed. Code depending on this will have to be rewritten to use the astPlugins prop, which functions differently.
  • allowNode has new arguments (node, index, parent) — node has different props, see renderer props
  • childBefore and childAfter props removed. Use root renderer instead.
  • parserOptions removed (new parser, so the old options doesn’t make sense anymore)

2.5.1 - 2017-11-11


  • Fix <br/> not having a node key (Alex Zaworski)

2.5.0 - 2017-04-10


  • Fix deprecations for React v15.5 (Renée Kooi)

2.4.6 - 2017-03-14


  • Fix too strict TypeScript definition (Rasmus Eneman)
  • Update JSON-loader info in readme to match webpack 2 (Robin Wieruch)


  • Add ability to pass options to the CommonMark parser (Evan Hensleigh)

2.4.4 - 2017-01-16


  • Fixed TypeScript definitions (Kohei Asai)

2.4.3 - 2017-01-12


  • Added TypeScript definitions (Ibragimov Ruslan)

2.4.2 - 2016-07-09


  • Added UMD-build (umd/react-markdown.js) (Espen Hovlandsdal)

2.4.1 - 2016-07-09


  • Update commonmark-react-renderer, fixing a bug with missing nodes (Espen Hovlandsdal)

2.4.0 - 2016-07-09


  • Plain DOM-node renderers are now given only their respective props. Fixes warnings when using React >= 15.2 (Espen Hovlandsdal)


  • New transformImageUri option allows you to transform URIs for images (Petri Lehtinen)

2.3.0 - 2016-06-06


  • The walker instance is now passed to the walker callback function (Riku Rouvila)

2.2.0 - 2016-04-20

  • Add childBefore/childAfter options (Thomas Lindstrøm)

2.1.1 - 2016-03-25

  • Add containerProps option (Thomas Lindstrøm)

2.1.0 - 2016-03-12


  • Join sibling text nodes into one text node (Espen Hovlandsdal)

2.0.1 - 2016-02-21


  • Update commonmark-react-renderer dependency to latest version to add keys to all elements and simplify custom renderers

2.0.0 - 2016-02-21


  • Breaking change: The renderer now requires Node 0.14 or higher. This is because the renderer uses stateless components internally.
  • Breaking change: allowNode now receives different properties in the options argument. See for more details.
  • Breaking change: CommonMark has changed some type names. Html is now HtmlInline, Header is now Heading and HorizontalRule is now ThematicBreak. This affects the allowedTypes and disallowedTypes options.
  • Breaking change: A bug in the allowedTypes/disallowedTypes and allowNode options made them only applicable to certain types. In this version, all types are filtered, as expected.
  • Breaking change: Link URIs are now filtered through an XSS-filter by default, prefixing “dangerous” protocols such as javascript: with x- (eg: javascript:alert('foo') turns into x-javascript:alert('foo')). This can be overridden with the transformLinkUri-option. Pass null to disable the feature or a custom function to replace the built-in behaviour.


  • New renderers option allows you to customize which React component should be used for rendering given types. See for more details. (Espen Hovlandsdal / Guillaume Plique)
  • New unwrapDisallowed option allows you to select if the contents of a disallowed node should be “unwrapped” (placed into the disallowed node position). For instance, setting this option to true and disallowing a link would still render the text of the link, instead of the whole link node and all it’s children disappearing. (Espen Hovlandsdal)
  • New transformLinkUri option allows you to transform URIs in links. By default, an XSS-filter is used, but you could also use this for use cases like transforming absolute to relative URLs, or similar. (Espen Hovlandsdal)

1.2.4 - 2016-01-28


  • Rolled back dependencies because of breaking changes

1.2.3 - 2016-01-24


  • Updated dependencies for both commonmark and commonmark-react-parser to work around an embarrassing oversight on my part.

1.2.2 - 2016-01-08


  • Reverted change from 1.2.1 that uses the dist version. Instead, documentation is added that specified the need for json-loader to be enabled when using webpack.

1.2.1 - 2015-12-29


  • Use pre-built (dist version) of commonmark renderer in order to work around JSON-loader dependency.

1.2.0 - 2015-12-16


  • Added new allowNode-property. See README for details.

1.1.4 - 2015-12-14


  • Set correct libraryTarget to make UMD builds work as expected

1.1.3 - 2015-12-14


  • Update babel dependencies and run prepublish only as actual prepublish, not install

1.1.1 - 2015-11-28


  • Fixed issue with React external name in global environment (react vs React)

1.1.0 - 2015-11-22


  • Add ability to allow/disallow specific node types (allowedTypes/disallowedTypes)

1.0.5 - 2015-10-22


  • Moved React from dependency to peer dependency.