convert-md-to-pdf

🔨 Convert Markdown file to PDF file

Give a ⭐️ if this project helped you!

Features

• ✅ Build PDF file form Markdown file
• ✅ Generate a PDF file in the same directory as the Markdown file
• ✅ Use one of the built-in themes
• ✅ Support custom path to a theme file
• ✅ Support set output directory and output file name
• ✅ Support paper orientation (portrait, landscape)
• ✅ Support paper border (default: 2cm for all sides)

Usage

Installation:

1npm install convert-md-to-pdf

1const { buildPDF } = require('convert-md-to-pdf');
2buildPDF({
3  source: '/tmp/source.md',
4  target: '/tmp/document.pdf',
5});

CLI

Installation:

1npm install -g convert-md-to-pdf

➡️ Use case: Regular usage

1convert-md-to-pdf /tmp/source.md

➡️ Use case: Display list of built-in themes

1convert-md-to-pdf -l

➡️ Use case: Change theme (built-in)

1convert-md-to-pdf /tmp/source.md -t clean
2convert-md-to-pdf /tmp/source.md -t dark
3convert-md-to-pdf /tmp/source.md -t paper
4convert-md-to-pdf /tmp/source.md -t nord
5convert-md-to-pdf /tmp/source.md -t orange

➡️ Use case: Custom theme

1convert-md-to-pdf /tmp/source.md -p ~/custom-theme.css
2convert-md-to-pdf /tmp/source.md --theme-path ~/custom-theme.css

➡️ Use case: Set directory for output file

1convert-md-to-pdf /tmp/source.md -d my-files/
2convert-md-to-pdf /tmp/source.md --directory my-files/

➡️ Use case: Set name of output file

1convert-md-to-pdf /tmp/source.md -o agreement.pdf
2convert-md-to-pdf /tmp/source.md --output agreement.pdf

➡️ Use case: Change paper orientation (default: portrait)

1convert-md-to-pdf /tmp/source.md -m landscape
2convert-md-to-pdf /tmp/source.md --mode landscape

➡️ Use case: Change paper border (default: 2cm for all sides)

1# order of values: top, right, bottom, left
2convert-md-to-pdf /tmp/source.md -b 1cm,1cm,1cm,1cm
3convert-md-to-pdf /tmp/source.md --border 2cm,3cm,2cm,3cm

➡️ Use case: Display the date of generation in the output file

During the conversion, the following phrase will be replaced with date & time. For example:

1Generated on: $$SIGNATURE$$

It will be replaced with:

1Generated on: 2023-09-08 23:16:35

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

Related

• convert-md-to-html - 🔨 Convert Markdown file to HTML file

Credits

Thanks to the authors of markdown-pdf

License

The MIT License @ 2018