A macro system for remarkjs
npm install remark-macro
Dimer is an open source project and CMS to help you publish your documentation online.
We believe every project/product is incomplete without documentation.
We want to help you publish user facing documentation, without worrying about tools or code to write.
This library gives you an opportunity to define macros, which can be used inside the markdown as follows.
``mdHello
Writing some markdown
[alert]
This is an alert message
[/alert]
`
The alert block is knows as a macro. By default the library will not parse this block. However, you can define a macro and then it will be parsed and all the contents will be forwarded to you.
`js
const macro = require('remark-macro')()
macro.addMacro('alert', function (content, props) {
assert.equal(content, 'This is an alert message')
assert.deepEqual(props, {})
})
`
``
npm i --save remark-macro
`js
const remark = require('remark')
const macro = require('remark-macro')()
const html = require('remark-html')
macro.addMacro('alert', function (content, props, { transformer, eat }) {
return {
type: 'AlertNode',
data: {
hName: 'div',
hClassNames: ['alert alert-note'],
hChildren: transformer.tokenizeBlock(content, eat.now())
}
}
})
const markdown =
[alert]
This is an alert
[/alert]
remark()
.use(macro.transformer)
.use(html)
.process(markdown, function (error, result) {
console.log(result.toString())
})
/**
This is an alert