This repository has been archived on 2022-01-04. You can view files and clone it, but cannot push or open issues/pull-requests.
Go to file
Timur Demin 647f506837
Add a GitHub link
2021-08-01 04:35:18 +05:00
cmd Add version display 2021-02-19 16:57:16 +05:00
internal/gemini Fix rendering of links-only paragraphs 2020-11-20 03:59:45 +05:00
.drone.yml Add Docker build files 2020-11-21 23:19:34 +05:00
.gitignore Ignore test files from Git 2020-11-08 17:38:15 +05:00
.goreleaser.yml Release v0.1.0 2020-11-20 16:35:07 +05:00
COPYING Add README and license code under GPLv3 2020-11-11 23:21:16 +05:00
Dockerfile Add Docker build files 2020-11-21 23:19:34 +05:00 Add a GitHub link 2021-08-01 04:35:18 +05:00
go.mod Add YAML front matter parsing support 2020-11-11 23:21:17 +05:00
go.sum Add YAML front matter parsing support 2020-11-11 23:21:17 +05:00
render.go Fix #8 2020-12-12 16:30:25 +05:00

This project has moved to GitHub

Hugo-to-Gemini converter


This repo holds a converter of Hugo Markdown posts to text/gemini (also named Gemtext in this README). The converter is supposed to make people using Hugo's entrance to Project Gemini, the alternate web, somewhat simpler.

The renderer is somewhat hasty, and is NOT supposed to be able to convert the entirety of possible Markdown to Gemtext (as it's not possible to do so, considering Gemtext is a lot simpler than Markdown), but instead a selected subset of it, enough for conveying your mind in Markdown.

The renderer uses the gomarkdown library for parsing Markdown. gomarkdown has a few quirks at this time, the most notable one being unable to parse links/images inside other links.


This program converts Hugo Markdown content files from content/ in accordance with templates found in gmnhg/ to the output dir. It also copies static files from static/ to the output dir.

For more details about the rendering process, see the doc attached to the program.

Usage of gmnhg:
  -output string
        output directory (will be created if missing) (default "output/")
  -working string
        working directory (defaults to current directory)


This program reads Markdown input from either text file (if -f filename is given), or stdin. The resulting Gemtext goes to stdout.

Usage of md2gmn:
  -f string
        input file

md2gmn is mainly made to facilitate testing the Gemtext renderer but can be used as a standalone program as well.


This program is redistributed under the terms and conditions of the GNU General Public License, more specifically version 3 of the License. For details, see COPYING.