markdown-to-mp

把 Markdown 转成适配微信公众号的 HTML，支持：

• Browser API（输入字符串，输出 HTML）
• Node API（输入 .md 文件，输出 .html 文件）
• CLI（md2mp）

核心渲染能力来源于 baoyu-markdown-to-html skill 的脚本，并做了 npm 包化与双端入口拆分。

Install

npm i markdown-to-mp

Browser Usage

import { renderMarkdownToHtml } from 'markdown-to-mp/browser';

const result = await renderMarkdownToHtml('# 标题\n\n你好，世界', {
  theme: 'grace',
  keepTitle: false,
  inlineStyles: true,
});

console.log(result.html);

Node Usage

import { convertMarkdownFile } from 'markdown-to-mp/node';

const result = await convertMarkdownFile('./article.md', {
  theme: 'default',
  keepTitle: false,
  backup: true,
  inlineCss: true,
});

console.log(result.htmlPath);

说明：

• Browser API 默认也会做 CSS 内联（与 Node 行为对齐）。
• 若你需要保留 <style> 而不内联，可传 inlineStyles: false（Browser）或 inlineCss: false（Node/CLI）。

CLI Usage

md2mp article.md --theme grace --keep-title

输出为 JSON，例如：

{
  "title": "文章标题",
  "author": "作者",
  "summary": "摘要",
  "htmlPath": "/abs/path/article.html",
  "backupPath": "/abs/path/article.html.bak-20260303194500",
  "contentImages": []
}

Themes

• default
• grace
• simple

Build

npm run build