Awesome
rehype-rewrite
<!--rehype:style=display: flex; height: 230px; align-items: center; justify-content: center; font-size: 38px;-->Rewrite element with rehype.
Installation
This package is ESM only: Node 12+ is needed to use it and it must be import
instead of require
.
npm install rehype-rewrite
Usage
<!--rehype:style=border-left-color: #fddf4c;--> <!--rehype:-->🚧 Migrate from rehype-rewrite
v2.x<!--rehype:style=color: red;--> tov3.x
<!--rehype:style=background-color: #4caf50; color: #fff;-->.rehype() - .use(rehypeRewrite, (node, index, parent) => {}) + .use(rehypeRewrite, { + rewrite: (node, index, parent) => {} + })
import { rehype } from 'rehype';
import rehypeRewrite from 'rehype-rewrite';
import stringify from 'rehype-stringify';
const html = `<h1>header</h1>`;
const htmlStr = rehype()
.data('settings', { fragment: true })
.use(rehypeRewrite, {
rewrite: (node, index, parent) => {
if(node.type == 'text' && node.value == 'header') {
node.value = ''
}
}
})
.use(stringify)
.processSync(html)
.toString()
<h1>header</h1>
Output:
<h1></h1>
Options
import { Plugin } from 'unified';
import { Root, Element, ElementContent, RootContent } from 'hast';
/** Get the node tree source code string */
export declare const getCodeString: (data?: ElementContent[], code?: string) => string;
export declare type RehypeRewriteOptions = {
/**
* Select an element to be wrapped. Expects a string selector that can be passed to hast-util-select ([supported selectors](https://github.com/syntax-tree/hast-util-select/blob/master/readme.md#support)).
* If `selector` is not set then wrap will check for a body all elements.
*/
selector?: string;
/** Rewrite Element. */
rewrite(node: Root | RootContent, index: number | null, parent: Root | Element | null): void;
};
declare const remarkRewrite: Plugin<[RehypeRewriteOptions?], Root>;
export default remarkRewrite;
selector?: string;
Select an element to be wrapped. Expects a string selector that can be passed to hast-util-select (supported selectors). If selector
is not set then wrap will check for a body all elements.
rewrite(node, index, parent): void;
Rewrite element.
Example
Example 1
import { rehype } from 'rehype';
import rehypeRewrite from 'rehype-rewrite';
import stringify from 'rehype-stringify';
const html = `<h1>header</h1><h1>header</h1><h1 class="title3">header</h1>`;
const htmlStr = rehype()
.data('settings', { fragment: true })
.use(rehypeRewrite, {
selector: 'h1',
rewrite: (node) => {
if (node.type === 'element') {
node.properties.className = 'test';
}
}
})
.use(stringify)
.processSync(html)
.toString()
<h1>header</h1> <h1>header</h1> <h1 class="title3">header</h1>
Output:
<h1 class="test">header</h1> <h1 class="test">header</h1> <h1 class="test">header</h1>
Example 2
import { rehype } from 'rehype';
import rehypeRewrite from 'rehype-rewrite';
import stringify from 'rehype-stringify';
const html = `<h1>header</h1>`;
const htmlStr = rehype()
.use(rehypeRewrite, {
rewrite: (node) => {
if (node.type == 'element' && node.tagName == 'body') {
node.properties = { ...node.properties, style: 'color:red;'}
}
}
})
.use(stringify)
.processSync(html)
.toString()
<h1>header</h1>
Output:
<html><head></head><body style="color:red;"><h1>header</h1></body></html>
Example 3
import { rehype } from 'rehype';
import rehypeRewrite from 'rehype-rewrite';
import stringify from 'rehype-stringify';
const html = `<h1>hello</h1>`;
const htmlStr = rehype()
.data('settings', { fragment: true })
.use(rehypeRewrite, {
rewrite: (node) => {
if (node.type == 'element' && node.tagName == 'h1') {
node.children = [ ...node.children, {
type: 'element',
tagName: 'span',
properties: {},
children: [
{type: 'text', value: ' world'}
]
}]
}
}
})
.use(stringify)
.processSync(html)
.toString()
<h1>hello</h1>
Output:
<h1>hello<span> world</span></h1>
Example 4
import { unified } from 'unified';
import remarkParse from 'remark-parse';
import rehypeRaw from 'rehype-raw';
import remark2rehype from 'remark-rehype';
import rehypeRewrite from 'rehype-rewrite';
import stringify from 'rehype-stringify';
const html = `<h1>hello</h1>`;
const htmlStr = unified()
.use(remarkParse)
.use(remark2rehype, { allowDangerousHtml: true })
.use(rehypeRaw)
.use(rehypeRewrite, {
rewrite: (node) => {
if (node.type == 'element' && node.tagName == 'h1') {
node.properties = { ...node.properties, style: 'color:red;' }
}
}
})
.use(stringify)
.processSync(html)
.toString()
<h1>hello</h1>
Output:
<h1 style="color:red;">Hello World!</h1>
Related
rehype-video
Add improved video syntax: links to.mp4
and.mov
turn into videos.rehype-attr
New syntax to add attributes to Markdown.rehype-ignore
Ignore content display via HTML comments, Shown in GitHub readme, excluded in HTML.remark-github-blockquote-alert
Remark plugin to add support for GitHub Alert.
Contributors
As always, thanks to our amazing contributors!
<a href="https://github.com/jaywcjlove/rehype-rewrite/graphs/contributors"> <img src="https://jaywcjlove.github.io/rehype-rewrite/CONTRIBUTORS.svg" /> </a>Made with action-contributors.
License
MIT © Kenny Wong