~humaid/godoc2markdown

A simple tool that converts godoc output to markdown
Add README and fix RegEx for title

clone

read-only
https://git.sr.ht/~humaid/godoc2markdown
read/write
git@git.sr.ht:~humaid/godoc2markdown

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

#godoc2markdown

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