// the find
atian25/yuque-exporter
export yuque to local markdown
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.