Humaid Alqasimi

< Go back

godoc2markdown

Clone with HTTPS: https://git.sr.ht/~humaid/godoc2markdown

Written in Go, licensed under the BSD-2-Clause license

Mailing list: ~humaid/general@lists.sr.ht (subscribe, archive)

Issue tracker: view tickets (submit ticket via email)

pkg.go.dev reference builds.sr.ht status

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.

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

6. Change log