# 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 2026-07-25. Also installable with debian: sudo apt install go-md2man.

## 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/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-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/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## Package facts

- **Package key:** brew:go-md2man
- **Package manager:** Homebrew
- **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>
- **Last updated:** 2026-07-25T20:55:23-04:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- go-md2man (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 2.0.7
## 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

## 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-r12: 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-r12: 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-2.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/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-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.9: normalized package name match | openSUSE Tumbleweed package metadata: go-md2man from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-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


## Combined YAML source

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


## Sources

- 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