Skip to content

Compiler

The compile command turns a source file into a PDF, picking the format from the file extension:

  • LaTeX (.tex) — a built-in engine, no TeX distribution (TeX Live, MiKTeX, etc.) required.
  • Markdown (.md / .markdown) — rendered with the generic template.

Both are typeset with MathJax and printed to PDF through the same headless-browser pipeline.

Usage

Compile a local file — the format is chosen from its extension:

scimon compile paper.tex
scimon compile notes.md

The PDF is written next to the input, reusing its name (paper.pdf, notes.pdf).

Custom output

Use -o / --output to choose the output file. The extension is normalized to .pdf automatically:

scimon compile paper.tex -o build/final.pdf

Remote files

You can compile a file straight from a URL:

scimon compile https://example.com/paper.tex
scimon compile https://example.com/readme.md

When no --output is given, the file name is derived from the URL.

Inside a downloads block

Any .tex URL listed in a downloads { } block is compiled to PDF automatically, so you can mix LaTeX sources with regular downloads:

downloads {
    https://example.com/paper.tex as "my-paper.pdf"
}

Formats

  • LaTeX — supported commands, environments and bundled packages.
  • Markdown — rendering details and options.