Skip to main content

Convert markdown files to beautiful books using a simple configuration file

Project description

Md2book

Md2book converts books written with markdown within multiple files into a single, standalone file, and allows exporting to pdf, ebook (epub), docx, odt, markdown or text. This projects makes it easy by using simple configuration files written in yaml. It supports markdown syntax, LaTeX equations, themes, css, fonts, and settings to easily configure the style.

Because an example is better than words, here is a document generated using md2book.

About md2book

Md2book is designed to be used by users that are comfortable with the command line interface and want a simple, free and fully customizale tool to manage theirs writings. If you want a more easy-to-use tool, with a GUI, check out scrivener (paying) or free online alternatives. If you want to use md2book, you will only need a markdown editor, like typora.

Why md2book instead of pandoc ?

Md2book uses pandoc, wkhtmltopdf and some python packages to generate documents. But I spent time optimizing the result to have better-looking documents. For example, python-docx is used to improve docx files generated by pandoc (but do not correct all pandoc issues). Md2book comes with predefined themes and fonts, and makes it easy to compile a document using styles, themes, fonts, to any target format. It has a template system, and read all you need to configure from a single file.

Start using md2book

All the instructions are available on the wiki.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

md2book-0.1.3.tar.gz (4.3 MB view hashes)

Uploaded Source

Built Distribution

md2book-0.1.3-py2.py3-none-any.whl (4.4 MB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page