Wechat Markdown Html Render

Overview

Render Markdown files into standalone HTML with separate style layers: basic-theme, text-theme, code-theme, and font-theme. Use scripts/render-markdown-html.js to generate deterministic output and keep code-block visuals independent from text theme.

Workflow

1. Inspect site-mechanism notes in references/wechat-bmpi-analysis.md when the request mentions wechat.bmpi.dev.
2. Install dependencies in the skill folder:

npm install

3. Render Markdown, you can pick a text-theme and code-theme and font-theme according to article contents:

node scripts/render-markdown-html.js \
  --input /path/to/input.md \
  --output /path/to/output.html \
  --text-theme geek-black \
  --code-theme wechat \
  --font serif

4. Validate that the output includes the four style blocks and that --text-theme and --code-theme can be changed independently.

Script Interface

• --input: Markdown source file path (required)
• --output: HTML output file path (required)
• --text-theme: normal | orange-heart | geek-black | minimal-dark | gold-sea (optional, default gold-sea)
• --code-theme: wechat | atomOneDark | atomOneLight | monokai | github | vs2015 | xcode (optional, default wechat)
• --font: serif | sans (optional, default serif)
• --title: Custom HTML title (optional)
• --custom-css-file: CSS file used only when --text-theme custom (optional)

Notes

• The script intentionally scopes markdown typography under #nice and syntax highlighting under .hljs/pre code selectors so code theme remains independent.
• The output is standalone HTML and can be copied into downstream editors.

WeChat MP editor list normalization (built into the renderer)

The script applies two post-processing rules specifically to survive the WeChat 公众号 editor's non-standard HTML ingester. These are NOT optional — they're enabled for every render — but worth knowing when reviewing output or extending the script:

1. Flatten \x3Cli>\x3Csection>…\x3C/section>\x3C/li> for leaf items. The MP editor drops the list marker (the 1. 2. 3. numbers, or • bullets) when a \x3Cli> contains a block-level child like \x3Csection>, and also inserts an extra blank row per item from the section's vertical margins. Fix: for \x3Cli> that does NOT contain a nested \x3Cul>/\x3Col>, the renderer unwraps the inner section and merges its typographic styles directly onto the \x3Cli>. Items with nested sub-lists keep the section wrapper (their sub-list layout depends on it).

2. Zero whitespace at \x3Col>/\x3Cul> boundaries and between sibling \x3Cli>s. The MP editor treats whitespace text nodes between \x3Cli> siblings (and at the start/end of a \x3Cul>/\x3Col>) as additional EMPTY list items, producing numbered/bulleted blank rows interleaved with the real ones. Newline-only stripping is NOT enough — spaces and tabs leak through and still trigger the bug. The renderer collapses all whitespace at those three positions: \x3Col> → first \x3Cli>, \x3C/li> → next \x3Cli>, last \x3C/li> → \x3C/ol> (and the same for \x3Cul>).

Symptoms in the MP editor preview when either rule fails:

• Rule 1 broken → no 1. 2. 3. markers, items show as plain paragraphs separated by blank rows.
• Rule 2 broken → 1. (blank) / 2. real / 3. (blank) / 4. real / … — count of visual rows ≈ 2N + 1 for N real items.

If you copy text out of the MP editor and the markers are missing, that's a clipboard artifact (markers are CSS ::marker pseudo-elements, not text nodes) — verify in the editor's visual preview, not the copied text.