The 2023 Web Development Community Survey is now open! Help share your insights with the web developer community


359 stars
33 forks
57 issues
Home page

The main design goal of Madoko is to enable light-weight creation of high-quality scholarly and industrial documents for the web and print, while maintaining John Gruber's Markdown philosophy of simplicity and focus on plain text readability.

With Madoko you can write full-blown academic articles with internal references, mathematical formulas, and bibliographies completely in Markdown and LaTex to get beautiful PDF or HTML output.

Supports "including" source files and referencing both CSS and javascript. Read the reference manual to learn more. An easy way to manage a large project is to split up the content and have one including the chuncks:

css : lib/style.css

script: lib/myAweseomScriptsAndAnalytics.js




To learn more about Madoko, check out the reference manual. To use it, simply:

  • Install with:
npm install madoko -g
  • Translating a Markdown document to HTML is as simple as:
madoko mydoc.mdk
  • To also generate a PDF file, use:
madoko --pdf --odir=out mydoc

Find more static site generators.