mrkeyoor.com_
Sun 27 Sept 19:22 UTC
Automationevaluationupdated 26 Aug 2026

md2wechat-skill review

md2wechat is a Chinese-first CLI and agent skill that turns Markdown into formatted WeChat Official Account articles, checks them, creates images, and can send finished work to the WeChat draft box. The README and linked operating guides are in Chinese; the license contains an English legal text, but the repository does not list a full English user guide.

+9stars / 7d
Verdict

Our md2wechat run installed 0 packages in 13 seconds, but the repository exposed no build or test command to verify the shipped CLI path. It is a sensible fit for Chinese WeChat creators who want agent-readable checks and accept the paid renderer, credential work, and source-available license. English-only teams, commercial users without written authorization, and anyone expecting free finished HTML should walk away.

We ran it

Lab card: what happened when we ran md2wechat-skillScreenshot of md2wechat-skill (md2wechat.cn)
Install✓ · 13s0 packages · 27 MB
Buildn/ano build script
Testsn/ano test script
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo329 files~44,688 lines of source · 4.3 MB · 3 CI workflows

Answers from our run

Does md2wechat-skill build from source?

Dependencies installed in 13 seconds (0 packages), and the project has no separate build step. We cloned commit d656438 into a clean Debian container with 3 CPUs and no project-specific setup.

Does md2wechat-skill have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does md2wechat-skill have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use md2wechat-skill?

English-only teams: the README and linked user guides are Chinese, with no full English usage guide listed.

What are the alternatives to md2wechat-skill?

WeChat Markdown Editor, wechat-format, mdnice. Our md2wechat run installed 0 packages in 13 seconds, but the repository exposed no build or test command to verify the shipped CLI path.

Setup3/513-second wrapper install; useful output needs several credentials
Docs4/5Detailed Chinese guides, but no full English usage path
Community4/53,594 stars and an August 2026 push with active pull requests
Maturity3/5v3.2.0 is broad, but our checkout exposed no test command

Who it’s for

Chinese-language creators who publish Markdown articles to a personal WeChat Official Account.
Claude Code or Codex users who want machine-readable discovery and explicit checks before draft creation.
Teams willing to buy the hosted renderer and a commercial license where their use requires one.
Operators with stable outbound IPs who can manage WeChat AppID, AppSecret, and allowlisting.

Who it’s NOT for

English-only teams: the README and linked user guides are Chinese, with no full English usage guide listed.
Companies assuming source-visible means unrestricted open source: the license requires written permission for for-profit internal work, client delivery, SaaS, white-labeling, and other commercial uses before its change date.
Users expecting the free mode to emit finished WeChat HTML: the README says it hands a prompt to an external model, while the paid API returns final HTML.
Publishers on changing home, office, or CI addresses: the WeChat credential guide warns that API calls need the actual caller IP on an allowlist.
Writers importing Word files or Obsidian notes directly: open issue 20 requests both capabilities rather than documenting them as supported.

Setup reality

Our sandbox install succeeded in 13 seconds. Npm added 0 packages, and the installed footprint was 27 MB. There was no build script and no test script, so both steps were skipped. Npm audit reported 0 known vulnerabilities.

Local inspection and configuration can start without WeChat access. Finished API conversion needs an md2wechat API key; image generation needs a configured provider; uploads and drafts need a WeChat AppID, AppSecret, and an allowed outbound IP.

The npm package wraps a Go CLI, while source builds require Go 1.26.1 or newer. The repository is Chinese-first, commercial use has separate license terms, and changing network addresses can break WeChat API calls even when the stored credentials remain correct.

The free path hands work back to an external model

md2wechat breaks WeChat publishing into commands an agent can inspect before it changes anything. inspect reports metadata, readiness targets, and blockers. preview writes successful API-rendered HTML to a file, while convert can upload assets or create a draft only when those effects are requested. Discovery commands expose themes, layout modules, providers, prompts, and embedded skills as JSON. The README names Claude Code, Codex, WorkBuddy, Kimi Work, Hermes Agent, and OpenClaw as intended callers.

The important split is commercial, not cosmetic. Free AI mode supplies 3 basic themes and produces a prompt for an outside language model to finish. The paid API is advertised at ¥199 for permanent access, returns finished HTML, lists 48 themes, and parses 53 recommended ::: layout names. Those counts describe different catalog dimensions, as the README carefully explains. A user wanting deterministic output inside the CLI is therefore choosing a hosted service as well as downloaded source.

A 13-second install does not verify the Go program

Our sandbox installed commit d656438 through npm in 13 seconds. It added 0 packages and occupied 27 MB on disk. The checkout itself contained 329 files and about 44,688 lines of source. GitHub identifies Go as the primary language, and the README requires Go 1.26.1 or newer for source builds. The npm route appears light because it distributes a wrapper around the compiled CLI rather than assembling a large JavaScript dependency tree.

No build script or target was available to our harness, so the build step was skipped. The checkout also exposed no test script or target, leaving no suite for our sandbox to run. Npm audit found 0 known vulnerabilities across all listed severities. That result covers the npm dependency view, not the behavior of the remote renderer, an image provider, or WeChat's APIs. The repository had 3 CI workflow files, no Dockerfile, and no tests directory in our scan.

What happened when we ran it

Our 3-CPU, 8 GB Debian sandbox completed the npm install in 13 seconds and measured a 27 MB footprint. Since 0 packages were added, the main practical finding is that obtaining the wrapper is cheap. The absence of build and test targets meant we could not use this run to check Markdown rendering, credential discovery, draft readiness, image generation, or publishing. We did not substitute hand-made commands because the measurement rules follow what the project exposes.

A skipped test step is weaker evidence than a passing one. The 329-file checkout has 3 CI workflows, which shows automation exists, but our local result cannot say those workflows cover the published binary or its service boundary. A buyer should run version --json, config validate --json, and doctor --json against the installed release, then preview a representative article before granting draft access. The repository's own command design makes that staged check possible.

WeChat credentials and a stable IP are operational requirements

Uploading an image, creating a draft, or creating an image post needs a WeChat AppID and AppSecret. The credential guide stores them in ~/.config/md2wechat/config.yaml or environment variables. Named accounts can hold several pairs, but using one for upload or draft effects also requires a valid md2wechat API key. The CLI can list account names locally without printing their secrets, a good fit for agents that need to discover targets without receiving raw credentials.

WeChat checks the caller's public IP as well as its credentials. The guide says allowlist changes may take 1 to 5 minutes and warns that home connections, office networks, and dynamic CI runners can change addresses. That is not a small deployment detail. A job can pass configuration validation and still fail when the network exit differs from the allowlisted machine. The paid service offers a fixed egress option, which further ties dependable automation to the hosted offering.

The license excludes common business uses until 2030

The repository is source available, not presently Apache-2.0 software. Its license permits personal non-commercial creation, learning, evaluation, registered nonprofit work, and contributions. It requires separate written authorization for for-profit internal workflows, paid client delivery, SaaS, paid templates or courses, white-label distribution, and commercial model-training use. The stated change date is January 1, 2030, after which versions move to Apache License 2.0 under the license terms.

That restriction is decisive for agencies and company content teams. The code being readable does not grant the usual commercial rights associated with an OSI-style license. GitHub reports NOASSERTION rather than a standard SPDX identifier, which matches the custom terms. Personal creators can still use it within the additional grant, including specified passive platform revenue, but anyone billing clients or embedding the themes in a product should resolve licensing before building a workflow around it.

August 2026 activity is active, while input formats remain narrow

GitHub showed 3,594 stars, 7 open issues and pull requests combined, and a last push on August 24, 2026. Release v3.2.0 was published July 24. The most recently updated work included draft updates and new image providers, which indicates that maintainers and contributors are still extending the command set. Open issue 20 asks for Word import with embedded images and an Obsidian connection, so Markdown remains the documented starting point.

md2wechat is best judged as a paid WeChat publishing workflow with a source-visible client, not as a free converter that happens to have premium extras. The 13-second installation removes friction at the front door, but the meaningful path crosses Chinese documentation, an API key, provider configuration, WeChat secrets, IP allowlisting, and license review. For a personal Chinese-language account already living in Markdown, those tradeoffs may be fair. For a business or manual publisher, a browser formatter is simpler.

Alternatives

ProjectWhat it isPick it when
WeChat Markdown EditorA browser editor that converts Markdown into layouts for WeChat and other Chinese platforms.pick this instead when interactive visual editing matters more than an agent-controlled publishing CLI.
wechat-formatA Markdown-to-WeChat formatter focused on copying styled output into the editor.pick this instead when you want a smaller formatting tool and will publish manually.
mdniceA web editor with themes for WeChat and other Chinese content platforms.pick this instead when browser previews and manual theme work suit the publishing process.

What people are saying

  1. [github-trending] geekjourneyx/md2wechat-skill

Sources

  1. md2wechat repository and Chinese README
  2. md2wechat source-available license
  3. WeChat credentials and IP allowlist guide
  4. md2wechat v3.2.0 release
  5. Word and Obsidian import request

More automation reviews

runner-images · agent-fleet-manager · kargo · Rose · alchemy · laya · the whole board →