md2html

md2html

Markdown to single HTML converter.

Feature

The md2html converts Markdown to a single file HTML.
All scripts and css will be embedded in the file
and thus the converted file is viewable even offline.
Additionally, the md2html has option to embed image to HTML by base64 encode
and hence the file is conveyable without any resources.

Sample

GitHub Pages

The html file is generated by following command

md2html example/*.md -e -t -m -s -f example/img/go.png -c example/css/custom-css.css -o gh-pages/index.html --html-title 示例文档

Installation

go install github.com/godoes/md2html/v2@latest

Usage

md2html -i <input Markdown> [-o <output HTML>] [-h <custom html title>] [-e] [-t] [-m] [-s] [-f <path to icon>]

if -o option was abbreviated, input Markdown file name + .html will be used as output HTML file name.

Embedding images

-e/--embed option enables embedding images that are located local storage by Base64 encoding.

Specify HTML title

-h/--html-title option enables setting custom html title, default is the output file name.

TOC

-t/--toc option enables generating TOC.

Using MathJax

-m/--mathjax option enables using MathJax.

Table row/col span

-s/--span option enables using rowspan/colspan for table tag

Favicon

-f/--favicon <path/to/icon> option enables embedding icon for favicon

Add custom CSS

-c/--css <path/to/css> option enables additional CSS

Example

Please execute the following commands to make example files.

# make html files from each markdown files
$ md2html -e example/*.md

# make a concatenated single html file from markdown files
$ md2html -e -t example/*.md -o example/concat.html

Custom JS & CSS

$ go get -d github.com/godoes/md2html
$ cd ${GOPATH}/src/github.com/godoes/md2html

###########################################################
# customize "{$GOPATH}/src/github.com/godoes/md2html/src/" #
###########################################################

$ npm install && gulp
$ assets.go.rb
$ go install

Use libraries

Go

• yuin/goldmark (License)
• yuin/goldmark-highlighting (License)
• PuerkitoBio/goquery (License)
• jessevdk/go-flags (License)

JS

• pkra/MathJax-single-file (License)

CSS

• sindresorhus/generate-github-markdown-css (License)