Markua is a Magical Typewriter. It is a Markdown-inspired format to write books. It was created by Peter Armstrong and used by LeanPub for writing books.

In this project I am going to create a Markua parser in Perl 5, or at least I start doing it and will implement enough of it so I can start writing the Perl Maven articles in Markua. That will allow me to easily include Perl Maven articles in an eBook published on LeanPub. For example to create the eBook of the Perl Maven Tutorial.

  1. Start writing the Markua parser in Perl - h1 tag
  2. Creating Makefile.PL and a CPAN distribution for the Markua Parser
  3. Travis-CI for the Markua Parser project
  4. Add test coverage reporting with Coveralls to Markua Parser in Perl
  5. Enable Appveyor (CI on Windows) for the Perl 5 Markua Parser


Some of my plans in not necessarily the right order

  • Parse all the headers h1-h6 tags
  • Free text (paragraph)
  • Include file
  • Embed image
  • Embed code
  • Inline code
  • Bold text
  • Bullet points: both numbered and plain
  • Some horizontal separator like the hr tag of HTML?
  • Some way to separate an "abstract" that will be displayed on the front page.