65 lines
1.9 KiB
JavaScript
65 lines
1.9 KiB
JavaScript
/**
|
||
* @typedef {import('micromark-util-types').Encoding} Encoding
|
||
* @typedef {import('micromark-util-types').Options} Options
|
||
* @typedef {import('micromark-util-types').Value} Value
|
||
*/
|
||
|
||
import {compile} from './lib/compile.js'
|
||
import {parse} from './lib/parse.js'
|
||
import {postprocess} from './lib/postprocess.js'
|
||
import {preprocess} from './lib/preprocess.js'
|
||
|
||
export {compile} from './lib/compile.js'
|
||
export {parse} from './lib/parse.js'
|
||
export {postprocess} from './lib/postprocess.js'
|
||
export {preprocess} from './lib/preprocess.js'
|
||
|
||
/**
|
||
* Compile markdown to HTML.
|
||
*
|
||
* > Note: which encodings are supported depends on the engine.
|
||
* > For info on Node.js, see:
|
||
* > <https://nodejs.org/api/util.html#whatwg-supported-encodings>.
|
||
*
|
||
* @overload
|
||
* @param {Value} value
|
||
* Markdown to parse (`string` or `Uint8Array`).
|
||
* @param {Encoding | null | undefined} encoding
|
||
* Character encoding to understand `value` as when it’s a `Uint8Array`
|
||
* (`string`, default: `'utf8'`).
|
||
* @param {Options | null | undefined} [options]
|
||
* Configuration.
|
||
* @returns {string}
|
||
* Compiled HTML.
|
||
*
|
||
* @overload
|
||
* @param {Value} value
|
||
* Markdown to parse (`string` or `Uint8Array`).
|
||
* @param {Options | null | undefined} [options]
|
||
* Configuration.
|
||
* @returns {string}
|
||
* Compiled HTML.
|
||
*
|
||
* @param {Value} value
|
||
* Markdown to parse (`string` or `Uint8Array`).
|
||
* @param {Encoding | Options | null | undefined} [encoding]
|
||
* Character encoding to understand `value` as when it’s a `Uint8Array`
|
||
* (`string`, default: `'utf8'`).
|
||
* @param {Options | null | undefined} [options]
|
||
* Configuration.
|
||
* @returns {string}
|
||
* Compiled HTML.
|
||
*/
|
||
export function micromark(value, encoding, options) {
|
||
if (typeof encoding !== 'string') {
|
||
options = encoding
|
||
encoding = undefined
|
||
}
|
||
|
||
return compile(options)(
|
||
postprocess(
|
||
parse(options).document().write(preprocess()(value, encoding, true))
|
||
)
|
||
)
|
||
}
|