Skip to content

Latest commit

 

History

History
35 lines (23 loc) · 1.71 KB

readme.md

File metadata and controls

35 lines (23 loc) · 1.71 KB

md => pdf workflow

What?

Personal convenience script for generating reasonable looking pdfs from a markdown file or folder while keeping script files and stylesheets organized.

Fairly specific to my habits, but in the off chance others may find it useful, here it is. I really do think WeasyPrint and upcoming CSS3 standards are vastly underappreciated, whether in Minimal Computing world, web design, or publishing (scholarly and otherwise).

Why?

  • paged.jsWeasyPrint + CSS3 Paged Media standards are pretty great
  • Even my "word processor" is styled with HTML/CSS, so why futz with LaTeX?
  • Invoking LaTeX as a "solution" for plaintext word processing undermines the power of markdown IMHO and hugely limiting--in terms of bulky platform specific dependencies, annoying syntax hurdles, typography limitations, and domain specific markup.

How?

  1. update env variables in mdtopdf.sh
  2. copy to your preferred user scripts folder, e.g. ~/.username
  3. symlink to your preferred bin, e.g. ln -s ~/.username/mdtopdf/mdtopdf.sh /usr/local/bin/mdtofpdf
  4. update/add stylesheet(s) in mdtopdf folder
  5. mdtopdf [-p output-prefix] [-f input-file-path] [-i input-folder-path] [-s stylesheet] [-d 1 debug mode]

Depending on?

But?

🚧 Of course, still working on this ... 🚧

  • What about accessibility of generated documents?
  • What about ensuring docs meet basic PDF standards?
  • What about images?
  • What about a simple resume template? See included cv.css