| name | magicmd |
| description | Use when the user wants public article URLs from WeChat, Juejin, CSDN, or technical blogs converted into Markdown packages, including batch conversion, local media, metadata, and extraction reports. |
MagicMD
MagicMD converts public article links into Markdown packages. Use it as a thin tool wrapper: call the published CLI, inspect the output, and report what was created.
User-Facing Prompts
When users are not sure what to ask, suggest concise prompts like these:
Use MagicMD to convert this public article into a Markdown package, then summarize the output files and warnings.
Read urls.txt, batch convert all public article links into output/articles with MagicMD, skip existing packages, and report failures from batch-report.md.
Use MagicMD doctor to check whether this workspace can convert WeChat, Juejin, CSDN, and generic article links.
Inspect this MagicMD output directory and tell me which articles need manual review before publishing.
When to Use
Use this skill for:
- Single public article URL to Markdown conversion.
- Batch conversion from a URL list.
- WeChat Official Account, Juejin, CSDN, and generic public article pages.
- Agent workflows that need
article.md, metadata, local images, videos, or extraction reports before publishing elsewhere.
Do not use it to bypass login, paywalls, private pages, CAPTCHA, rate limits, or platform access controls.
Command Choice
Prefer an installed CLI when available:
magicmd doctor
magicmd "<url>" -o output/
magicmd batch urls.txt -o output/
If magicmd is not installed, use the PyPI package through uvx:
uvx --from "magicmd==0.7.1" magicmd doctor
uvx --from "magicmd==0.7.1" magicmd "<url>" -o output/
uvx --from "magicmd==0.7.1" magicmd batch urls.txt -o output/
For repeated batch runs:
magicmd batch urls.txt -o output/ --skip-existing
magicmd batch urls.txt -o output/ --overwrite
Workflow
- Run
magicmd doctor when the environment is unknown.
- Put multiple URLs in a plain text file, one URL per line.
- Convert with
magicmd "<url>" -o <output_dir> or magicmd batch <urls.txt> -o <output_dir>.
- Verify each output package contains
article.md, metadata.json, and extraction-report.json.
- Check local media directories such as
images/ or videos/ when media download is enabled.
- For batch jobs, inspect
batch-report.md and batch-report.json.
- If conversion is incomplete, inspect
extraction-report.json, debug.html when present, and the source URL.
Reporting Back
Tell the user:
- Output directory path.
- Number of successful and failed conversions.
- Important warnings from
extraction-report.json or batch-report.md.
- Whether media was downloaded locally.
- Any limits encountered, such as 403, login requirement, video hotlink protection, or missing dynamic resources.
- Next suggested action: publish, manually review, retry with browser support, or collect failure evidence.
Keep the original URL and output package intact so the user can compare against the source page.
