# Install go-md2man with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper

Converts markdown into roff (man pages). Version 2.0.7 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:go-md2man
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install go-md2man
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install go-md2man
```

  Evidence: MacPorts ports tree: textproc/go-md2man/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add go-md2man
```

  Evidence: Alpine Linux edge package indexes: go-md2man from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install go-md2man
```

  Evidence: Debian stable package indexes: go-md2man from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install go-md2man
```

  Evidence: Fedora Rawhide package metadata: go-md2man from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#go-md2man
```

  Evidence: nixpkgs package indexes: pkgs/by-name/go/go-md2man/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S go-md2man
```

  Evidence: Arch Linux sync databases: go-md2man from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install go-md2man
```

  Evidence: openSUSE Tumbleweed package metadata: go-md2man from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:go-md2man
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/go-md2man>
- **Version:** 2.0.7
- **Source summary:** Converts markdown into roff (man pages)
- **Homepage:** <https://github.com/cpuguy83/go-md2man>
- **Repository:** <https://github.com/cpuguy83/go-md2man>
- **Upstream docs:** <https://github.com/cpuguy83/go-md2man#readme>
- **License:** MIT
- **Source archive:** <https://github.com/cpuguy83/go-md2man/archive/refs/tags/v2.0.7.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- go-md2man (cli)
- go-md2man (alias)

## Build dependencies

- go

## Install behavior

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

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.0.7
- Local data: ok
- Upstream repository: https://github.com/cpuguy83/go-md2man
- Upstream latest detected: v2.0.7 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

go-md2man is a small Go utility that converts Markdown into roff-formatted Unix manual pages.

### Project history

The public repository was created in 2014. Its README gives the enduring scope of the project: use the blackfriday Markdown processor to turn Markdown source into man-page roff output.

### Adoption history

go-md2man found a durable niche in Go CLI release workflows, where maintainers often write documentation in Markdown but still need man pages for Unix packages. Homebrew and Linux package listings make it available as a standalone build-time or packaging helper.

### How it is used

Practitioners run go-md2man with an input Markdown file and an output path for the generated man page. Go module users can install it with go install, and Go 1.24-era projects can add it as a go tool entry for repeatable documentation generation.

### Why package nerds care

For package users, go-md2man is valuable because it bridges developer-authored Markdown and distribution-friendly man pages without a larger documentation stack.

### Timeline

- 2014: Public GitHub repository created.
- 2019: v2.0.0 tag line established module-aware releases.
- 2025: v2.0.7 release published.

### Related projects

- blackfriday supplies the Markdown processing layer used by go-md2man.

### Sources

- <https://api.github.com/repos/cpuguy83/go-md2man>
- <https://formulae.brew.sh/formula/go-md2man>
- <https://github.com/cpuguy83/go-md2man>
- <https://github.com/cpuguy83/go-md2man/releases>


## Security Notes

library-like package without higher-risk signals.

- **Geiger risk:** green / low
- library-like package without higher-risk signals

## Source Database Details

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

## Other Package-Manager Records

- Debian apt - go-md2man - 2.0.4-1: normalized package name match | Debian stable package indexes: go-md2man from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | utility to create manpages from markdown | https://github.com/cpuguy83/go-md2man
- Nix - go-md2man: normalized package name match | nixpkgs package indexes: pkgs/by-name/go/go-md2man/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - go-md2man - 2.0.3+ds1-1: normalized package name match | Ubuntu 24.04 LTS package indexes: go-md2man from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | utility to create manpages from markdown | https://github.com/cpuguy83/go-md2man
- apk - go-md2man - 2.0.7-r11: normalized package name match | Alpine Linux edge package indexes: go-md2man from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Utility to convert markdown to man pages | https://github.com/cpuguy83/go-md2man
- apk - go-md2man-doc - 2.0.7-r11: normalized package name match | Alpine Linux edge package indexes: go-md2man-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Utility to convert markdown to man pages (documentation) | https://github.com/cpuguy83/go-md2man
- dnf - go-md2man - 2.0.7-1.fc45: normalized package name match | Fedora Rawhide package metadata: go-md2man from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Converts markdown into roff (man pages) | https://github.com/cpuguy83/go-md2man
- pacman - go-md2man - 2.0.7-1: normalized package name match | Arch Linux sync databases: go-md2man from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A markdown to manpage generator | https://github.com/cpuguy83/go-md2man
- zypper - go-md2man - 2.0.0+git20190314.f79a8a8-2.6: normalized package name match | openSUSE Tumbleweed package metadata: go-md2man from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Tool to converts markdown into man pages | https://github.com/cpuguy83/go-md2man
- MacPorts - go-md2man: normalized package name match | MacPorts ports tree: textproc/go-md2man/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [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.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [ronn](https://www.automicvault.com/pkg/brew/ronn/) - Shares av.db curated category or tags: cli, developer-tools, documentation, markdown, roff.
- [action-docs](https://www.automicvault.com/pkg/brew/action-docs/) - Shares av.db curated category or tags: cli, developer-tools, documentation, markdown.
- [docfx](https://www.automicvault.com/pkg/brew/docfx/) - Shares av.db curated category or tags: cli, developer-tools, documentation, markdown.
- [docmd](https://www.automicvault.com/pkg/brew/docmd/) - Shares av.db curated category or tags: cli, developer-tools, documentation, markdown.
- [github-markdown-toc](https://www.automicvault.com/pkg/brew/github-markdown-toc/) - Shares av.db curated category or tags: cli, developer-tools, documentation, markdown.
- [grip](https://www.automicvault.com/pkg/brew/grip/) - Shares av.db curated category or tags: cli, developer-tools, documentation, markdown.
- [gtree](https://www.automicvault.com/pkg/brew/gtree/) - Shares av.db curated category or tags: cli, developer-tools, documentation, markdown.
- [mdbook](https://www.automicvault.com/pkg/brew/mdbook/) - Shares av.db curated category or tags: cli, developer-tools, documentation, markdown.
- [txt2man](https://www.automicvault.com/pkg/brew/txt2man/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, converts, developer, developer-tools, documentation.

## Combined YAML source

View the package source record on GitHub. [combined/go-md2man.yml](https://github.com/automic-vault/db/blob/main/combined/go-md2man.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
- external package-manager database matches
- cross-ecosystem install command graph
