explaingit

lyricat/wechat-format

4,516JavaScriptAudience · writerComplexity · 1/5Setup · easy

TLDR

A browser-based tool that converts Markdown into WeChat-safe HTML for writers publishing articles on WeChat Official Accounts. It fixes common formatting breakages caused by WeChat's editor stripping CSS styles.

Mindmap

mindmap
  root((wechat-format))
    Markdown Input
      Plain text writing
      Standard symbols
    WeChat Output
      Inline styles
      Surviving editor paste
    Fixed Problems
      List rendering fix
      Link to footnotes
      Layout for readers
    Limitations
      No longer maintained
      Replaced by Quaily
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Format a Markdown article so it displays correctly when pasted into WeChat's web editor.

USE CASE 2

Convert external hyperlinks into numbered footnotes since WeChat blocks clickable links in article bodies.

USE CASE 3

Apply WeChat-compatible list styling so bullet points and numbered lists do not break in the editor.

Tech stack

JavaScriptHTMLCSSMarkdown

Getting it running

Difficulty · easy Time to first run · 5min

Browser-based tool with no described installation steps. Note: project is no longer actively maintained, the author recommends Quaily Markdown Tools as a replacement.

No license information was mentioned in the explanation.

In plain English

wechat-format is a browser-based formatting tool built for writers who publish articles on WeChat Official Accounts. WeChat Official Accounts is the platform built into the WeChat messaging app that businesses, journalists, and creators in China use to distribute articles directly to subscribers. Writing articles there is done through WeChat's own web editor, which accepts HTML but strips out many standard CSS styles when you paste content in. The tool works by taking Markdown, a plain-text writing format that uses symbols like asterisks and hashes to indicate formatting, and converting it into HTML with styles carefully designed to survive WeChat's editor without being overwritten. Standard Markdown-to-HTML converters produce output that looks fine in browsers but breaks inside WeChat because the editor resets styles on certain elements. Three specific problems motivated the project. Standard list rendering broke in WeChat because the editor reset the CSS on unordered and ordered list elements. The tool applied inline styles to fix that. Hyperlinks were also a problem: WeChat does not allow clickable external links in article bodies, so the tool converted links into numbered footnote references and printed the actual URLs at the bottom of the article. And the overall layout was designed to match what WeChat readers expect, rather than generic browser defaults. The README is short and does not describe setup steps or configuration options in detail. It does note that the project is no longer actively maintained. The author points readers to a replacement tool called Quaily Markdown Tools for the same conversion task.

Copy-paste prompts

Prompt 1
I have a Markdown article I want to publish on WeChat Official Accounts. Help me write it in Markdown so it will convert cleanly using wechat-format, avoiding elements that tend to break in WeChat's editor.
Prompt 2
My WeChat article has several external links, but WeChat does not allow clickable links. Show me how wechat-format handles this and how I should structure my links in Markdown so footnotes are generated correctly.
Prompt 3
I pasted my article into WeChat's editor and the bullet point lists look broken. Explain what wechat-format does differently with list styles to fix this problem.
Prompt 4
wechat-format is no longer maintained and the author recommends Quaily Markdown Tools as a replacement. Compare the two tools and help me decide which to use for formatting WeChat articles.
Open on GitHub → Explain another repo

← lyricat on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.