# Install yuque-dl with Homebrew

Knowledge base downloader for Yuque. Version 1.0.85 via Homebrew; verified 2026-06-28.

## Install

```sh
sudo av install brew:yuque-dl
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install yuque-dl
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:yuque-dl
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/yuque-dl>
- **Version:** 1.0.85
- **Source summary:** Knowledge base downloader for Yuque
- **Homepage:** <https://github.com/gxr404/yuque-dl>
- **Repository:** <https://github.com/gxr404/yuque-dl>
- **Upstream docs:** <https://github.com/gxr404/yuque-dl#readme>
- **License:** ISC
- **Source archive:** <https://registry.npmjs.org/yuque-dl/-/yuque-dl-1.0.85.tgz>
- **Last updated:** 2026-06-28T07:40:31Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- yuque-dl (cli)
- yuque-dl (alias)

## Dependencies

- node

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.0.85
- Package-manager updated: 2026-06-28
- Local data: ok
- Upstream repository: https://github.com/gxr404/yuque-dl
- info: No cached GitHub release or tag data was available.
## Project history and usage

yuque-dl is a TypeScript/Node.js CLI for downloading Yuque knowledge bases and documents to local Markdown. Its niche is personal and team knowledge-base backup: turning hosted Yuque pages, images, and attachments into files that can be archived, searched, or previewed locally.

### Project history

The GitHub repository was created in August 2023. The README describes a command-line downloader for Yuque knowledge bases, single documents, multi-document batches, and all knowledge bases visible to the current account.

The changelog shows continued maintenance through 2025 and 2026, with features such as incremental downloads, attachment ignoring, single-document support, user and batch subcommands, and fixes for password-protected download flows.

### Adoption history

GitHub metadata showed more than two thousand stars by July 2026, notable for a specialized Chinese knowledge-base export tool. Its adoption is tied less to broad developer infrastructure and more to the practical need to keep Yuque content portable.

### How it is used

Typical usage is to pass a Yuque knowledge-base or document URL to yuque-dl and choose an output directory. For private or password-protected material, the README documents token, cookie-key, and password options, while public material can be downloaded directly when Yuque allows access.

The tool can also serve the downloaded content with a bundled preview server, making it useful as both a backup/export utility and a local review tool for migrated documentation.

### Why package nerds care

yuque-dl is a useful package-manager entry because it packages a regional SaaS escape hatch as a repeatable CLI. It is the kind of tool users discover only when they need to make hosted knowledge portable, then want it installable from the same places as other backup utilities.

### Timeline

- 2023-08-14: GitHub repository is created.
- 2025-03-13: Changelog records incremental download support.
- 2025-06-25: Changelog records an option for ignoring attachments.
- 2026-03-17: Changelog records single-document download support.
- 2026-06-27: Changelog records user and batch subcommands for multi-knowledge-base download.

### Related projects

- Yuque is the hosted knowledge-base platform whose content yuque-dl exports.
- VitePress is used by yuque-dl's preview-server workflow for local browsing of downloaded content.

### Sources

- <https://api.github.com/repos/gxr404/yuque-dl>
- <https://github.com/gxr404/yuque-dl>
- <https://raw.githubusercontent.com/gxr404/yuque-dl/main/CHANGELOG.md>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** yuque-dl
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew.
- [karakeep](https://www.automicvault.com/pkg/brew/karakeep/) - Shares av.db curated category or tags: cli, knowledge-management, productivity.
- [mdzk](https://www.automicvault.com/pkg/brew/mdzk/) - Shares av.db curated category or tags: cli, knowledge-base, markdown, productivity.
- [backlog-md](https://www.automicvault.com/pkg/brew/backlog-md/) - Shares av.db curated category or tags: cli, markdown, productivity.
- [bulletty](https://www.automicvault.com/pkg/brew/bulletty/) - Shares av.db curated category or tags: cli, markdown, productivity.
- [deck](https://www.automicvault.com/pkg/brew/deck/) - Shares av.db curated category or tags: cli, markdown, productivity.
- [ekphos](https://www.automicvault.com/pkg/brew/ekphos/) - Shares av.db curated category or tags: cli, markdown, productivity.
- [evernote2md](https://www.automicvault.com/pkg/brew/evernote2md/) - Shares av.db curated category or tags: cli, markdown, productivity.
- [fanyi](https://www.automicvault.com/pkg/brew/fanyi/) - Shares av.db curated category or tags: cli, nodejs, productivity.
- [markdown-toc](https://www.automicvault.com/pkg/brew/markdown-toc/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, markdown, node, productivity.

## Combined YAML source

View the package source record on GitHub. [combined/yuque-dl.yml](https://github.com/automic-vault/db/blob/main/combined/yuque-dl.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
