A simple tool that converts godoc output to markdown
e878d1e9 — Humaid AlQassimi 3 years ago
Add README and fix RegEx for title
ceb45a75 — Humaid AlQassimi 3 years ago
Initial commit



You can also use your local clone with git send-email.


Visit project page on humaidq.ae

#1. Description

This is a simple Unix-like tool which allows you to pipe the output of go doc to generate Markdown.

The purpose of this tool is to allow private Go projects generate Markdown documentation, where websites like GoDoc has no access to the repository.

#2. Requirements

The following packages must be installed on your system.

  • Go
  • Git
  • GNU Make

#3. Copying and contributing

This program is written by Humaid AlQassimi, and is distributed under the BSD 2 Clause license.

#4. Download and install

$ git clone https://git.sr.ht/~humaid/godoc2markdown
$ cd godoc2markdown
$ make install

#5. Example Usage

If you want to generate a Markdown of the package in the current directory, and save it to a file, you can run.

$ go doc -all . | godoc2markdown > DOCUMENTATION.md