Markdown2HTML

A simple Markdown to HTML converter that transforms Markdown content into HTML code, which is sanitized to prevent XSS attacks.

Getting Started

$3

To get started with ES Modules, simply import the module and use it in your code:

``js
import { Converter } from '@kklab/markdown2html';

const output = Converter.toHTML('# Hello, World!');

// Output:
//

Hello, World!

`html




`

Usage

$3

The Converter can be initialized with Markdown content and then converted to HTML code using the toHTML method.

`js
const markdown = # Heading 1;

const converter = new Converter(markdown);

const output = converter.toHTML();

// Output:
//

Heading 1

The Converter can sanitize potentially unsafe HTML content while converting it into valid HTML code. It uses DOMPurify for sanitization, and you can configure it to allow specific attributes or elements as needed.

`js
const markdown = # Heading 1

Link
;

const converter = new Converter(markdown, {
domPurifyConfig: {
ADD_ATTR: [
'target',
],
},
});

const output = converter.toHTML();

// Output:
//

Heading 1

The Converter supports customizing the rendering of Markdown elements using the setMarkedExtensions method. This allows you to override specific renderers, such as link, to generate tailored HTML output. Combined with DOMPurify, the output can be both secure and precisely formatted.

`js
const markdown = # Heading 1

Link
;

const converter = new Converter(markdown)
.setMarkedExtensions([
{
renderer: {
link({ href, title, text }) {
return ${text};
},
},
},
])
.setDOMPurifyConfig({
ADD_ATTR: [
'target',
],
});

const output = converter.toHTML();

// Output:
//

Heading 1

The Converter supports adding syntax highlighting to Markdown code blocks with the setMarkedExtensions method. By integrating the marked-highlight and highlight.js libraries, you can customize the appearance of code blocks and apply language-specific styles.

`js
import 'highlight.js/styles/default.min.css';
import { markedHighlight } from 'marked-highlight';
import highlight from 'highlight.js/lib/core';
import javascript from 'highlight.js/lib/languages/javascript';

highlight.registerLanguage('javascript', javascript);

const markdown = # Heading 1

\\\javascript
console.log('Hello, World!');
\\\
;

const converter = new Converter(markdown)
.setMarkedExtensions([
markedHighlight({
langPrefix: 'language-',
highlight(code, lang) {
const options = {
language: highlight.getLanguage(lang) ? lang : 'javascript',
};
return highlight.highlight(code, options).value;
},
}),
]);

const output = converter.toHTML();

// Output:
//

Heading 1

console.log('Hello, World!');
// 

`bash
npm run dev
`

Testing

To run the tests for this package, run:

`bash
npm run test
``