BrowseProductivity & docs tools
Pandoc
A Haskell library and command-line tool that converts documents between many markup formats, such as Markdown, HTML, LaTeX, docx and EPUB.
Tested on Linux
Use it
Linux x86_64
You need first
- System packages:
LaTeX (optional, for PDF output)
download latest linux-amd64 release tarball and extract into ~/.local
V=$(curl -fsSL https://api.github.com/repos/jgm/pandoc/releases/latest | python3 -c 'import sys,json;print(json.load(sys.stdin)["tag_name"])') && curl -fsSLo /tmp/pandoc.tgz https://github.com/jgm/pandoc/releases/download/$V/pandoc-$V-linux-amd64.tar.gz && mkdir -p $HOME/.local && tar xvzf /tmp/pandoc.tgz --strip-components 1 -C $HOME/.local
Check that it works
pandoc --versionThe output should contain “Features: +server +lua”.
First thing to try
cat > in.md <<'EOF'
# Hello
Some *emphasis* and a [link](https://example.com).
EOF
cat > upper.lua <<'EOF'
function Str(el)
return pandoc.Str(el.text:upper())
end
EOF
cat > myreader.lua <<'EOF'
function Reader(input)
local blocks = {}
for line in tostring(input):gmatch("[^\n]+") do
table.insert(blocks, pandoc.Para{pandoc.Str(line)})
end
return pandoc.Pandoc(blocks)
end
EOF
cat > mywriter.lua <<'EOF'
function Writer(doc, opts)
return "WORDS: " .. pandoc.utils.stringify(doc) .. "\n"
end
EOF
cat > lines.txt <<'EOF'
first line
second line
EOFpandoc -f markdown -t html in.mdRun pandoc -f markdown -t html <file> to convert a Markdown file to HTML.
What it does
- Convert documents between many markup formatsTested
How to use it
- Run
pandoc -f markdown -t html <file>to convert a Markdown file to HTML. - Change the
-f(from) and-t(to) values to pick other formats.
- Run
- Change the document structure with custom filtersTested
How to use it
- Write a Lua filter file, for example one that returns
pandoc.Str(el.text:upper())from aStrfunction. - Run
pandoc --lua-filter <filter.lua> -t plain <file>to apply it during conversion.
- Write a Lua filter file, for example one that returns
- Use your own Lua readers and writersTested
How to use it
- Write a Lua reader with a
Reader(input)function and a Lua writer with aWriter(doc, opts)function. - Run
pandoc -f <reader.lua> -t <writer.lua> <file>to convert with them.
- Write a Lua reader with a
- Make PDFs through LaTeX, Groff ms or HTMLNot tested
How far pickfit got
Linux x86_64
- Installs
- Starts
- 3 of 4 features work
- Works offline
Good for
- convert a Markdown file to PDF
- convert Word docx documents to other markup formats
- create slide shows such as reveal.js or beamer
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 15 Nov 2026
- Version pandoc 3.14
Differences the test machine hit
- README: sudo dpkg -i $DEB
In the test: No root in this box; used the release tarball extracted into ~/.local instead - README: Pandoc can also produce PDF output via LaTeX, Groff ms, or HTML (LaTeX optional prerequisite)
In the test: A separate PDF engine (LaTeX, groff, or weasyprint with system pango libs) must be installed; none was available without root