Converts Markdown to Gemini gemtext with Go. Working with streams and UNIX pipes, utilizing Go channels. Processes streams of input line by line and forwards blocks to the next pipeline stage.
| main.go | ||
| pipeline.go | ||
| preproc.go | ||
| proc.go | ||
| README.md | ||
md2gmi
Convert Markdown to Gemini gemtext markup with Go. Working with streams and pipes for UNIX like behavior utilizing Go channels. Processing streams line by line is deliberately slightly more challenging than it needs to be to play around with go state machines.
See the gemini protocol and the protocol spec.
Internally md2gmi does a 1st pass that constructs the core layout for gemtext. This is then streamed to the 2nd pass line by line. The 2nd pass will convert links and stream line by line to the output.
Usage
Usage of ./md2gmi:
-f string
specify a .md (Markdown) file to read from, otherwise stdin (default)
-o string
specify a .gmi (gemtext) file to write to, otherwise stdout (default)
Example
go get github.com/n0x1m/md2gmi
cat file.md | md2gmi
md2gmi -in file.md -out file.gmi
The top part of this readme parses to
## md2gmi
Convert Markdown to Gemini gemtext[1] markup with Go. Working with streams and pipes for UNIX like behavior utilizing Go channels. Processing streams line by line is deliberately slightly more challenging than it needs to be to play around with go state machines.
=> https://gemini.circumlunar.space/docs/gemtext.gmi 1: gemtext
See the gemini protocol[1] and the protocol spec[2].
=> https://gemini.circumlunar.space/ 1: gemini protocol
=> https://gemini.circumlunar.space/docs/specification.gmi 2: protocol spec
Internally md2gmi does a 1st pass that constructs the core layout for gemtext. This is then streamed to the 2nd pass line by line. The 2nd pass will convert links and stream line by line to the output.