# Install feishu2md with Homebrew

Convert feishu/larksuite documents to markdown. Version 2.4.5 via Homebrew; verified 2026-07-26.

## Install

```sh
sudo av install brew:feishu2md
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install feishu2md
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:feishu2md
- **Package manager:** Homebrew
- **Version:** 2.4.5
- **Source summary:** Convert feishu/larksuite documents to markdown
- **Homepage:** <https://github.com/Wsine/feishu2md>
- **Repository:** <https://github.com/Wsine/feishu2md>
- **Last updated:** 2026-07-26T11:37:55+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- feishu2md (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 2.4.5
## Project history and usage

feishu2md is a Go command-line and Docker-distributed utility for exporting Feishu or Lark documents to Markdown.

### Project history

The official README describes the project as a Go implementation for downloading Feishu documents as Markdown. It also states that the original author no longer uses Feishu documents and that the project has moved to community maintenance, with maintainers invited through pull requests.

The README documents a split between the current v2 workflow for newer Feishu documents and an archived v1 support branch for older document support, with v1.4.0 identified as the old-document archive.

### Adoption history

Official distribution is centered on GitHub releases, a Docker image, and the Homebrew formula listed in the package-manager metadata. Its adoption is naturally niche because it depends on Feishu/Lark Open API credentials and document permissions.

### How it is used

Users create a Feishu/Lark self-built app, grant document, media, drive, and wiki read permissions, then store the App ID and App Secret through the tool's config command. The CLI downloads a single document, a folder, or a wiki to Markdown; the Docker mode exposes a small web service for pasting document links.

### Why package nerds care

For package maintainers, feishu2md is a small example of a SaaS-export CLI: it wraps a vendor API, stores credentials locally, ships cross-platform binaries, and gives users a reproducible way to pull cloud documents into plain-text repositories.

### Timeline

- 2022: v1.0.0 release published on GitHub.
- 2024: v2 releases document the transition to the newer Feishu document API.
- 2025: v2.4.5 released on 2025-04-08.

### Related projects

- The README thanks chyroc/lark and chyroc/lark_docs_md as related Feishu/Lark tooling.

### Sources

- <https://github.com/Wsine/feishu2md>
- <https://raw.githubusercontent.com/Wsine/feishu2md/main/README.md>
- <https://github.com/Wsine/feishu2md/releases>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: $XDG_CONFIG_HOME/feishu2md/config.json, ~/.config/feishu2md/config.json
- macOS: ~/Library/Application Support/feishu2md/config.json
- Windows: %AppData%\feishu2md\config.json

## Credential files

- Linux: $XDG_CONFIG_HOME/feishu2md/config.json, ~/.config/feishu2md/config.json
- macOS: ~/Library/Application Support/feishu2md/config.json
- Windows: %AppData%\feishu2md\config.json

## Combined YAML source

View the package source record on GitHub. [combined/feishu2md.yml](https://github.com/mxcl/pkgdb/blob/main/combined/feishu2md.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph