README.md

I hate accounting, especially invoicing. It's a repetitive, mind-boggling task, that steals away my energy; thus should be
handled by a machine. Believe me, I would give my pinky toe if I never ever had to do it again.
At most I just want to scribble a few notes and be done with it.
Maybe Tyler King hat the same thoughts while he created Markdown Invoice to solve the problem.
It turns Markdown invoices into HTML or PDF.
Of course his tool is totally rad, so I borrowed it and adjusted it to my own needs.
This somehow grew out of my hand and I added a bunch of features and gave it a new name - karban.
Karban is a hacker-friendly, static invoice generator. It's kinda like Jekyll, but for invoices.

How?

Simple. Put your invoices into the invoices/ directory.
See sample.md for an example invoice in Markdown and its PDF output.

Step 3: Install composer

Step 4: Download Karban

Step 5: Go into the Karban folder and run composer

cd karban && composer install

Credits

All credits go to Tyler King who created the original Markdown Invoice.

Note

At the moment you have to fiddle around with the page breaks when things go awry. That's a known issue caused by wkhtmltopdf. Yeah, it sucks; the only alternative might be to look for an alternative or wait for a proper fix since all the available hacks are messy. For the time being, you can use <div class="pagebreak"></div> anywhere in your markdown invoice to force a page break.