All Versions
27
Latest Version
Avg Release Cycle
51 days
Latest Release
1261 days ago

Changelog History
Page 1

  • v13.0.0 Changes

    October 14, 2020

    🚧 This is a giant change for remark. It replaces the 5+ year old internals with a new low-level parser: micromark. The old internals have served billions of users well over the years, but markdown has changed over that time. micromark comes with 100% CommonMark (and GFM as an extension) compliance, and (WIP) docs on parsing rules for how to tokenize markdown with a state machine. micromark, and micromark in remark, is a good base for the future.

    Migration

    • ⚑️ Update all the remark* packages you are using in package.json
    • 0️⃣ Did you use GFM (tables and so, used to be the default)? Now add remark-gfm
    • ⚑️ Try running it all. If it fails, you are probably using a syntax extension which hasn’t been updated yet, there are issues open on the issue trackers of those plugins already
    • πŸ‘€ Compare the previous output to the new output: anything wrong? See below for the changelog which might cover it. Otherwise, It’s probably because remark is now CommonMark (or GFM) compliant.
      Please compare with those projects if the new behavior is correct or not (CommonMark Dingus, or create a gist for GFM).
      πŸ“œ Does remark not match those reference parsers? Please open an issue here!

    πŸ”„ Changes

    πŸ“œ remark-parse

    πŸ‘€ remark-parse now defers its work to micromark and mdast-util-from-markdown. micromark is a new, small, complete, and CommonMark compliant low-level markdown parser. from-markdown turns its tokens into the previously (and still) used syntax tree: mdast. Extensions to remark-parse work differently: they’re a two-part act. See for example micromark-extension-footnote and mdast-util-footnote.

    • πŸ”„ change: commonmark is no longer an option β€” it’s the default
    • 🚚 move: gfm is no longer an option β€” moved to remark-gfm
    • βœ‚ remove: pedantic is no longer an option β€” this legacy and buggy flavor of markdown is no longer widely used
    • βœ‚ remove: blocks is no longer an options β€” it’s no longer suggested to change the internal list of HTML β€œblock” tag names

    remark-stringify

    πŸ‘€ remark-stringify now defers its work to mdast-util-to-markdown. It’s a new and better serializer with powerful features to ensure serialized markdown represents the syntax tree (mdast), no matter what plugins do. Extensions to it work differently: see for example mdast-util-footnote.

    options
    • πŸ”„ change: commonmark is no longer an option, it’s the default
    • πŸ”„ change: emphasis now defaults to *
    • πŸ”„ change: bullet now defaults to *
    • 🚚 move: gfm is no longer an option β€” moved to remark-gfm
    • 🚚 move: tableCellPadding β€” moved to remark-gfm
    • 🚚 move: tablePipeAlign β€” moved to remark-gfm
    • 🚚 move: stringLength β€” moved to remark-gfm
    • βœ‚ remove: pedantic is no longer an option β€” this legacy and buggy flavor of markdown is no longer widely used
    • βœ‚ remove: entities is no longer an option β€” with CommonMark there is almost never a need to use character references, as character escapes are preferred
    • πŸ†• new: quote β€” you can now prefer single quotes (') over double quotes (") in titles

    πŸ”„ Changes to output / the tree

    πŸ›  All of these are for CommonMark compatibility. They’re all fixes. Most of them are inconsequential to most folks.

    • notable : references (as in, links [text][id] and images ![alt][id]) are no longer present as such in the syntax tree if they don’t have a corresponding definition ([id]: example.com). The reason for this is that CommonMark requires [text *emphasis start][undefined] emphasis end* to be emphasis.
    • notable : it is no longer possible to use two blank lines between two lists or a list and indented code. CommonMark prohibits it. For a solution, use an empty comment to end lists (<!---->)
    • inconsequential: whitespace at the start and end of lines in paragraphs is now ignored
    • πŸ“œ inconsequential: <mailto:foobarbaz> are now correctly parsed, and the scheme is part of the tree
    • inconsequential: indented code can now follow a block quote w/o blank line
    • inconsequential: trailing indented blank lines after indented code are no longer part of that code
    • inconsequential: character references and escapes are no longer present as separate text nodes
    • inconsequential: character references which HTML allows but CommonMark doesn’t, such as &copy w/o the semicolon, are no longer recognized
    • inconsequential: the indent field is no longer available on position
    • πŸ›  fix: multiline setext headings
    • πŸ›  fix: lazy lists
    • πŸ›  fix: attention (emphasis, strong)
    • πŸ›  fix: tabs
    • πŸ›  fix: empty alt on images is now present as an empty string
    • …plus a ton of other minor previous differences from CommonMark

    Thanks

    Thanks to Salesforce, Gatsby, Vercel, and Netlify, and our other backers for sponsoring the work on micromark!
    πŸ‘ To support our continued work, back us on OpenCollective!

  • v13.0.0-alpha.1 Changes

    October 03, 2020

    πŸ‘€ See GH-536

  • v13.0.0-alpha.0 Changes

    October 02, 2020

    πŸ‘€ See GH-536

  • v12.0.1 Changes

    July 17, 2020
    • 963292f Change master in links
    • ⚑️ 63888af Update sponsors
  • v12.0.0 Changes

    March 30, 2020
  • v11.0.2 Changes

    November 09, 2019

    πŸš€ See [email protected] and [email protected]

    Project

    • πŸ“¦ 8b2a3ff Add funding fields to packages
    • πŸ‘• 4e020e8 Fix dtslint
    • πŸ”Œ 0114ff9 Add remark-jargon to list of plugins
  • v11.0.1 Changes

    August 01, 2019
    • d282fef Fix export of remark options type
  • v11.0.0 Changes

    July 20, 2019

    πŸ’₯ Breaking

    Project

    • a47c3c9 Add more links to unified for examples of use
    • 🚚 a93db25 Remove community health files
    • πŸ”¨ 1578bdf Refactor prose
    • 🚚 70ada4a Move URLs from HTTP to HTTPS
    • edb284a Add more badges

    πŸ”Œ Plugins

    • πŸ”Œ 927083c Add remark-code-frontmatter to plugins
    • πŸ”Œ 0ee5336 Add remark-code-extra to List of Plugins
    • ⚑️ 5d13f8e Update list of plugins
    • πŸ”Œ cc7867b Add remark-tree-sitter to list of plugins
    • πŸ”Œ cca8385 Add remark-sectionize to plugins.md
    • πŸ”Œ f4230e3 Add remark-capitalize to list of plugins
    • πŸ”Œ cf52183 Add remark-utf8s and remark-code-screenshot to list of plugins
    • πŸ”Œ caaf374 Add remark-redactable to list of plugins
  • v10.0.1 Changes

    November 15, 2018

    No code changes, ...but
    🍱 Announcing the unified collective! πŸŽ‰
    Read more about it on Medium Β»

    Project

    • ⚑️ cbf5cea Update docs
  • v9.0.1 Changes

    December 09, 2020