# 使用 Homebrew, Nix, pacman 安装 mdserve

查看 mdserve 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:mdserve
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install mdserve
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#mdserve
```

  证据: nixpkgs package indexes: pkgs/by-name/md/mdserve/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S mdserve
```

  证据: Arch Linux sync databases: mdserve from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## 软件包事实

- **软件包键:** brew:mdserve
- **软件包管理器:** Homebrew
- **版本:** 1.1.0
- **来源摘要:** Fast markdown preview server with live reload and theme support
- **主页:** <https://github.com/jfernandez/mdserve>
- **仓库:** <https://github.com/jfernandez/mdserve>
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- mdserve (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 1.1.0
## 项目历史与用法

mdserve is a Rust Markdown preview server built for live-rendering Markdown during AI-assisted coding sessions. Its README emphasizes zero configuration, a single binary, live reload, ephemeral sessions, GFM, Mermaid, directory mode, and built-in themes.

### 项目历史

The GitHub repository was created on 2025-09-22. The README positions mdserve narrowly: it is a local preview companion for AI coding agents, not a documentation site generator, static site server, or general-purpose authoring system.

The project includes a Claude Code plugin so an agent can decide when rendered Markdown is useful and start a preview for longer documents, tables, diagrams, or other content that is hard to inspect raw in a terminal.

### 采用历史

Official installation paths include Homebrew for macOS, an install script for Linux, Cargo, Arch Linux, Nix, source builds, and GitHub release binaries. The input package-manager facts list Homebrew, Nix, and pacman packages.

GitHub metadata showed hundreds of stars within its first year, consistent with a tool aimed at the newly visible AI-agent workflow around generated Markdown.

### 使用方式

The basic workflow is `mdserve README.md` for a single file or `mdserve docs/` for a directory. Optional flags set hostname, port, and whether to open a browser automatically.

The README documents single-file mode for focused previewing and directory mode for serving `.md` and `.markdown` files with sidebar navigation and file watching.

### 为什么软件包爱好者会关心

mdserve is package-nerd relevant because it packages a modern local preview stack into one installable CLI, explicitly avoiding the heavier documentation-site-generator category. It reflects the 2025-era shift where generated Markdown, Mermaid diagrams, and agent-written docs became routine terminal artifacts.

### 时间线

- 2025: Public GitHub repository created.
- 2025: README documented Homebrew, Cargo, Arch, Nix, source, and release-binary installation paths.
- 2026: Repository metadata showed continuing activity and hundreds of stars.

### Related projects

- The README names mdBook, Docusaurus, and MkDocs as tools outside mdserve's intended scope.
- The acknowledgments cite Axum, markdown-rs, and Catppuccin as implementation or theme influences.

### 来源

- <https://api.github.com/repos/jfernandez/mdserve>
- <https://github.com/jfernandez/mdserve#readme>
- <https://github.com/jfernandez/mdserve/tree/main/docs>
- source_facts.package-manager


## 安全说明

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

- **Geiger 风险:** blue / 中
- broad file, network, media, or database tool signal

## 其他软件包管理器记录

- Nix - mdserve: normalized package name match | nixpkgs package indexes: pkgs/by-name/md/mdserve/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- pacman - mdserve - 1.1.0-1: normalized package name match | Arch Linux sync databases: mdserve from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Fast markdown preview server with live reload and theme support | https://github.com/jfernandez/mdserve


## Combined YAML source

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


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph