rehype-urls

Rehype plugin to rewrite URLs of href and src attributes.

Installation

1npm install rehype-urls

Usage

Given this markup:

1<article>
2  <img src="http://internal.site/image.jpg">
3  <a href="http://internal.site/page.html">page</a>
4  <a href="http://example.com">link</a>
5</article>

You can use the following script:

1var rehype = require('rehype')
2var urls = require('rehype-urls')
3
4rehype()
5  .use(urls, removeBaseUrl)
6  .process(input, handleOutput)
7
8function removeBaseUrl (url) {
9  if (url.host === 'internal.site') {
10    return url.path
11  }
12}

Which will transform it into:

1<article>
2  <img src="/image.jpg">
3  <a href="/page.html">page</a>
4  <a href="http://example.com">link</a>
5</article>

You can also pass in an object:

1rehype()
2  .use(urls, { transform: removeBaseUrl })
3  .process(input, handleOutput)

Mutate nodes

It's also possible to mutate the URL nodes directly. This example will add target="_blank" to any external links:

1var rehype = require('rehype')
2var urls = require('rehype-urls')
3
4rehype()
5  .use(urls, blankExternal)
6  .process(input, handleOutput)
7
8function blankExternal (url, node) {
9  if (url.host !== 'internal.site') {
10    node.properties.target = '_blank'
11  }
12}

License

Apache-2.0