wechat-md-render

Creates a stable pre-rendered Markdown copy for WeChat article typesetting.

5|1|Updated Jul 31, 2026
One-click install
npx skills add https://github.com/shiker1996/wechat-editroom --skill wechat-md-render-shiker1996
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wechat-md-render
Source: https://github.com/shiker1996/wechat-editroom/tree/main/skills/wechat-md-render
Command: npx skills add https://github.com/shiker1996/wechat-editroom --skill wechat-md-render-shiker1996

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Before converting WeChat official account Markdown into HTML, editors need a stable intermediate file that preserves the original body text, sources, images, and comments while normalizing explicit Mermaid, ECharts, and inline module markers. This Skill produces that pre-rendered copy so downstream typesetting stages work from a consistent input. ## Core Features & Use Cases - Lossless Pre-render Copy: Reads a UTF-8 Markdown file and writes a <stem>.rendered.md file in the same directory, keeping headings, paragraphs, links, footnotes, images, and HTML comments intact. - Explicit Diagram Marker Normalization: Normalizes Mermaid, ECharts, and inline module fences only when the user or source document explicitly uses them; ordinary prose, arrows, and lists are never auto-converted into diagrams. - Pipeline Integration: Designed to be invoked standalone or by the wechat-article-typeset stage, returning the actual output path in both cases. - Use Case: A content team drafts a WeChat article in Markdown containing a Mermaid flowchart fence. Running this Skill generates article.rendered.md, which the typesetting stage then converts into final WeChat HTML. ## Quick Start Ask the assistant to use wechat-md-render to generate a pre-rendered copy of your article Markdown file before typesetting it for WeChat.

Frequently Asked Questions about wechat-md-render

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I pre-render Markdown before converting it to WeChat HTML?

Run the script with node scripts/md-render.js followed by your input Markdown path, and optionally an output path. It writes a <stem>.rendered.md file in the same directory and prints the actual output path for downstream typesetting stages.

Does this tool automatically convert lists or arrows into Mermaid diagrams?

No. The script never converts ordinary prose, arrows, lists, or code into diagrams. Mermaid normalization only happens when the user explicitly requests it or the source document already uses a mermaid code fence.

What happens to images, footnotes, and comments during pre-rendering?

They are preserved unchanged. The output gates require that headings, paragraphs, links, footnotes, images, and HTML comments all remain intact, and unrecognized fences are kept as-is.

Can this Skill generate WeChat HTML, images, or design files?

No. It only produces a rendered Markdown copy. HTML conversion, screenshots, uploads, previews, and design assets are explicitly out of scope and handled by other stages such as wechat-article-typeset.

Why does the pre-render script fail on my Markdown file?

The script exits with an error if the input file does not exist, is not a regular file, is empty, or cannot be read as UTF-8. It also fails if the written output ends up empty, so verify the source file content first.