remark plugin to manage links
Last updated 8 months ago by wooorm .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install remark-bookmarks 
SYNC missed versions from official npm registry.


Build Coverage Downloads Size Sponsors Backers Chat

remark plugin to manage links.



npm install remark-bookmarks


Say we have the following file,

`remark-bookmarks` is on [npm][]!

And our script, example.js, looks as follows:

const vfile = require('to-vfile')
const remark = require('remark')
const bookmarks = require('remark-bookmarks')

  .use(bookmarks, {
    bookmarks: {
      github: '',
      npm: ''
  .process(vfile.readSync(''), function(err, file) {
    if (err) throw err

Now, running node example yields:

`remark-bookmarks` is on [npm][]!



remark().use(bookmarks[, options])

Manage links.


The URLs to share across Markdown documents (Object.<string>). References are case insensitive.


Pass overwrite: true to ensure that references are used consistently. By default (false), the existing references in the file will take precedence over anything defined globally.


options.bookmarks is used and injected into the tree as definitions when the content references them. This could open you up to a cross-site scripting (XSS) attack if you pass user provided content as bookmarks.

This may become a problem if the Markdown later transformed to rehype (hast) or opened in an unsafe Markdown viewer.


  • remark-inline-links — Transform references and definitions into normal links and images
  • remark-defsplit — Transform links and images into references and definitions with URI-based identifiers
  • remark-reference-links — Transform links and images into references and definitions
  • remark-unlink — Remove all links, references and definitions


See in remarkjs/.github for ways to get started. See for ways to get help.

This project has a code of conduct. By interacting with this repository, organization, or community you agree to abide by its terms.


MIT © Ben Briggs

Current Tags

  • 3.0.0                                ...           latest (8 months ago)

6 Versions

  • 3.0.0                                ...           8 months ago
  • 2.1.2                                ...           a year ago
  • 2.1.1                                ...           a year ago
  • 2.1.0                                ...           2 years ago
  • 2.0.0                                ...           2 years ago
  • 1.0.0                                ...           4 years ago
Maintainers (2)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 3
Dependencies (2)
Dev Dependencies (15)
Dependents (1)

Copyright 2014 - 2016 © |