Do2pdf

brew install do2pdf

Example:

git clone https://github.com/<relevant-repo>/do2pdf # adjust URL if known cd do2pdf make && sudo make install do2pdf often wraps pandoc and highlight . Install them first:

# macOS brew install pandoc highlight sudo apt install pandoc highlight 2. Basic Usage Convert a Stata do-file to a PDF report: do2pdf

sudo apt install do2pdf

do2pdf my_analysis.do Output: my_analysis.pdf in the same directory. do2pdf my_analysis.do -o output/script_report.pdf 3. Common Options | Option | Description | |--------|-------------| | -o <file> | Output PDF file path | | --style <style> | Syntax highlighting style (e.g., github , monokai , tango ) | | --line-numbers | Add line numbers to the code | | --title "My Title" | Set document title | | --author "Name" | Set author metadata | | --toc | Include a table of contents | | --template <file> | Use a custom LaTeX/HTML template | | -f | Force overwrite existing PDF |

pandoc my_analysis.do -o output.pdf \ --highlight-style=tango \ --pdf-engine=xelatex \ -V mainfont="DejaVu Sans Mono" For Stata syntax specifically, you may need to specify: brew install do2pdf Example: git clone https://github

→ Install highlight: same method as above.

do2pdf script.do --style monokai --line-numbers --toc -o script.pdf Convert multiple do-files into one PDF: do2pdf part1.do part2.do part3.do -o combined.pdf Use with custom template (e.g., for company letterhead): do2pdf analysis.do --template company.template -o report.pdf Pipe content directly: cat my_script.do | do2pdf -o from_stdin.pdf 5. Troubleshooting Error: pandoc: command not found → Install pandoc: brew install pandoc (macOS) or sudo apt install pandoc (Linux)

do2pdf script.do --lang stata → Check that your do-file contains plain text and not binary content. Try converting with: do2pdf my_analysis

pandoc my_script.do -o test.pdf If that fails, the issue is with do2pdf 's wrapper; use pandoc directly. Use pandoc directly with syntax highlighting:

→ Make sure your .do file extension is recognized. Force language:

If you are referring to a different do2pdf (e.g., a custom script or from another software ecosystem), please clarify. The most common usage is for Stata do-files . 1. Installation On macOS (Homebrew):