Pretty Doc
Pretty Doc is quick and convenient markdown to html converter with beautiful templates, aiming to provide a simple tool to generate beautiful docs for common use.
[TOC]
Features
- Beautiful built-in templates:
default
,bootstrap
,parallel
- Code highlight
- Markdown TOC supports
- Easy to customize template
- Support GFM( GitHub Flavored Markdown ) syntax
Examples
Installation
Pretty Doc is relied on ruby
environment. Please make sure that your system has ruby
installed.
gem install pretty_doc
Usage
# Usage: pretty_doc [options] files
#
# Options:
#
# -o, --output [path] output to a given folder
# -t, --template [folder] choose a template
# -l, --line-numbers enable line numbers for codes
# -v, --version output the version number
# -h, --help output usage information
Generate TOC
Use [TOC]
or {:toc}
in your markdown file to generate table of contents and use [NO_TOC]
or {:.no_toc}
to ignore specific header.
Example:
Pretty Doc
==========
[NO_TOC]
[TOC]
## Feature
## Usage
Create a custom template
template structure
├── init.rb
├── style.scss
└── template.html.erb
TODO
- Add docs for how to create a custom template
- Add file toc support
- Optimize templates for Windows
- Add custom fonts and javascripts supports