md2html

md2html

Markdown to single HTML converter.

Feature

The md2html converts Markdown to a single file HTML.
All scripts and css will be embeded 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/nocd5.png -c example/css/custom-css.css -o gh-pages/index.html

Installation

GO111MODULE=on go get github.com/nocd5/md2html

Usage

md2html -i <input Markdown> [-o <output HTML>] [-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.

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 concatinated single html file from markdown files
$ md2html -e -t example/*.md -o example/concat.html

Custom JS & CSS

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

###########################################################
# customize "{$GOPATH}/src/github.com/nocd5/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)
• cferdinandi/smooth-scroll (License)

CSS

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