Texode

TeXode

TeXode renders Markdown as LaTeX. Full documents and books can be rendered, or merely the code blocks, allowing you to forgo syntax highlighting in favor of MathJax-powered LaTeX blocks. Once LaTeX is produced, you will need to render the file with a LaTeX installation. This can then be converted to bear pdfs, amongst other formats. Alternatively, if you built only the code blocks, you can simply embed MathJax in a page rendering your Markdown as HTML.

Installation is as easy as copying and pasting the following command into your terminal:

$ git clone https://github.com/mattneary/TeXode.git; \
  echo ""; cd TeXode/lib; \
  ./install.sh `git log --pretty=format:'%h' -n 1`; cd ../..; \
  rm -rf TeXode/

This will clone the repo into your current directory, then run the install script, and remove any intermediary files created in the process.

Future updates can be performed from within TeXode by the --update flag, and your version number checked by the -v flag.

Why LaTeX?

1. LaTeX automatically assigns section counts.
2. LaTeX has a very traditional appearance.
3. LaTeX automatically paginates and numbers pages, making your documents more appropriate for print.

Usage

The command line interface of TeXode is designed to be as simple as possible, using sensible default behaviors. The two primary commands allow for files to be built to a directory, either rendering code for MathJax driven LaTeX or converting the full document to LaTeX. These commands work great within a Makefile.

Building Full Documents

To build full documents to LaTeX, pass the -b [book|document] *.md build/folder.

$ texode -b book intro.md definitions.md build/folder

Building Only Code

To build just the code of documents to LaTeX, pass the -c *.md build/folder.

$ texode -c intro.md definitions.md build/folder

Author

TeXode is a project by Matt Neary designed for his upcoming book, Tarpits & Abstraction.