finds.dev

atian25/yuque-exporter

export yuque to local markdown

View on GitHub

★ 366TypeScriptMITupdated May 2024

// the take

A CLI tool for bulk-exporting Yuque documents to local Markdown files. It calls the Yuque API, downloads images, rewrites internal links to relative paths, and preserves TOC structure as a local directory tree. Useful if you're escaping Yuque's paywall changes and want your content somewhere you control.

Handles the non-trivial parts of Yuque export: image download, link rewriting from Yuque-internal URLs to relative paths, and TOC-driven directory structure rather than a flat dump. Ships as an npx one-liner so there's nothing to install permanently. The pipeline is clearly separated — fetch metadata, build tree, process content — which makes it readable and patchable. Has actual tests with fixtures, not just a README promise.

Last commit is May 2024 and several TODO items that affect real usage (illegal characters in filenames, multi-account/team support, attachment download) are still open. Attachment download is blocked on authentication the tool doesn't implement, which is a hard wall for anyone with files attached to docs. The README is entirely in Chinese, which limits its reach given how many non-Chinese developers use Yuque for technical writing. Rate limit handling is also unfinished per the TODO — hit the 5000/hour cap and you get no useful feedback.

We read the README, the directory tree and a key source file in July 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
366
Forks
43
Language
TypeScript
License
MIT
Last commit
10 May 2024

// nearby

If yuque-exporter isn't quite it.

All repos →