Markdown to HTML Converter#

Convert Markdown files or strings to well-formatted HTML, suitable for web display or CMS publishing.

Quick Start#

bash

node scripts/md2html.js <input.md> [output.html]

Or via stdin:

bash

echo "# Hello World" | node scripts/md2html.js -

Or as a Node.js module:

javascript

var converter = require('./scripts/md2html.js');
var html = converter.markdownToHtml(markdownString);

Parameters#

ParameterRequiredDescriptioninput.mdYesPath to source Markdown file, or - for stdinoutput.htmlNoOutput path (defaults to input name with .html)

Supported Markdown Features#

FeatureMarkdown SyntaxHTML OutputHeadings# h1 through ###### h6``<h1> through <h6>Bold**text**``<strong>text</strong>Italic*text*``<em>text</em>Inline code `code` ```<code>code</code>`Code blocks```` ```lang ``` `````<pre><code class="language-lang">`Links`[text](url)textImages<img src="url" alt="alt">`Unordered lists`- item` or `* itemitemOrdered lists1. item<ol><li>item</li></ol>`Blockquotes`> texttextHorizontal rule---or***``ParagraphsBlank line separationtext`

Design Principles#

• Zero dependencies — Pure Node.js, works with v0.12+ (no npm install needed)
• CMS-friendly — Output is clean HTML suitable for direct database insertion
• No wrapper HTML — Outputs content HTML only (no <html>, <head>, <body>)
• Safe escaping — Code blocks escape < and > to prevent XSS

Typical Use Cases#

1. AI Content Pipeline — LLM generates Markdown → convert to HTML → publish to CMS
2. Static site generation — Batch convert .md files to .html
3. Documentation — Convert README.md to HTML for web display

Pipeline Integration Example#

For automated AI content pipelines that generate Markdown but publish HTML:

javascript

var converter = require('./scripts/md2html.js');
var rawMarkdown = llmResponse.choices[0].message.content;
var htmlContent = converter.markdownToHtml(rawMarkdown);
// Now publish htmlContent to your CMS API