Evaluate the code written in your documents with Pandoc and Lua
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
perro tuerto 879abd7b84
Starting refactoring
1 hour ago
dist Starting refactoring 1 hour ago
man Renaming 2 weeks ago
opt From filter to reader... again 3 weeks ago
scripts Finished scripts refactoring 4 days ago
src Starting refactoring 1 hour ago
tests Scripts 'make_dist' and 'test' ready 5 days ago
LICENSE.txt Repo ordering 3 weeks ago
README.md More error analysis; refactoring of lit.puts 3 days ago


👾 Computable Pandoc

Computable Pandoc is a Pandoc filter written in Lua for literate and natural programming (LIN programming), i.e.: "Programming [...] as the process of creating works of literature".



  1. Go to Releases.
  2. Download the latest version of lin.lua.
  3. Done!


With lin.lua downloaded and Pandoc installed, do:

pandoc -L PATH/TO/lin.lua -t FORMAT DOC

For example, if DOC is source.md and the output FORMAT is HTML, do:

pandoc -L PATH/TO/lin.lua -t html source.md


Learn how to do LIN programming here.


Clone this repo:

git clone https://git.cuates.net/perro/computable-pandoc.git

Enter the repo:

cd computable-pandoc

Inside, do the tests:

pandoc lua scripts/test.lua

For other kind of tests, do:

pandoc lua scripts/test.lua -h

For other scripts, do:

pandoc lua scripts/SCRIPT

For example, do:

pandoc lua scripts/make_dist.lua



This wouldn't be possible without these projects and their collaborators:

  • Pandoc: universal document converter and parser; handles the requirements for LIN.
  • Lua: programming language; enables LIN.
  • Fennel: Lisp dialect with full Lua compatibility; allows native evals for Lisp.


Computable Pandoc is under GPLv3.

Happy hacking :)