PDFML - PDF Markup Language
Write dynamic PDF files using a markdown language similar to HTML, Using the EJS rendering engine.
This project is built using pdfmake and ejs
Additionally, this will improve and auto fix your document defintion, so you don't have to worry about the PDF file being broken.
npm i pdfml --saveconst pdfml = require('pdfml');
pdfml.render({
path : PATH_TO_FILE_NAME
data : RENDER_DATA
});Create an ejs file, for example:
<pdfml page-margins="25 140 24 30" page-size="LETTER">
<head>
<styles>
<npStyle font-size="50" bold="true"></npStyle>
<hdStyle font-size="14" color="red"></hdStyle>
<hpStyle font-size="14" color="red"></hpStyle>
</styles>
<header>Header</header>
<footer>
</footer>
</head>
<body>
<text style="npStyle"><%= text %></text>
</body>
</pdfml>
const pdfml = require('pdfml');
let dd = pdfml.getDD(STRING_OR_PATH_TO_FILE, RENDER_DATA, OPTIONS);const pdfml = require('pdfml');
let buffer = await pdfml.generatePDF(docDefinition, OPTIONS);const pdfml = require('pdfml');
///in your express router
app.get("/:filename", async (req, res, next) => {
try {
//you can query some data here
let doc = await pdfml.render({
path: Path.join(__dirname, req.params.filename), //path to your ejs file
data: {}, // data for context in your ejs file,
fonts: {}, //if you want to supply fonts
});
//set the content type to pdf
res.setHeader("Content-type", "application/pdf");
//set the attachment header
res.attachment("PDF_FILE.pdf"); // remove this if you want to open the pdf in the browser
res.send(doc);
} catch (err) {
next(err);
}
});Synce this is powered by ejs, you can use the include function and setup multiple templates. This is very useful when you have generic parts of your document that you want to reuse.
Consider the following file structure:
- templates/
- header.pdfml
- footer.pdfml
- main.pdfml
You can then use the include function to include the header and footer in your main file:
<%- include('./templates/header.pdfml') %>
<body>
<text>Main Content</text>
</body>
<%- include('./templates/footer.pdfml') %>PDFML is the root element for the PDF document, and there is where you define all document-level Settings.
Using the attributes of the <pdfml> element (see example) you can define document level settings, such as page size, orientation, margins, etc.
<pdfml page-size="LETTER" page-orientation="landscape" page-margins="25 140 24 30">
</pdfml>(or text)
A p element is for displaying a paragraph of text.
<p>This is plain text</p>(also known as stack)
A div will keep the inner elements together, the inner elemets will be diplayed in block mode.
<div>
<text>This is one block of text</text>
<text>This is another block of text</text>
</div>columns will keep the inner elements together, the inner elemets will be diplayed inline mode.
<columns>
<text>This is one block of text</text>
<text>This is another block of text</text>
</columns>For tables use the the following elements (body, row, cell):
Note: The table will be rendered in a single page, if you want to break the table in multiple pages use the dont-break-rows="true" attribute.
Note: PDFML is resilent to a mismatched number of columns in each row, it will fill the missing columns with empty cells. It will also fill in the widths and/or the heights attribute with the default width (auto) for each missing column.
```xml
<table header-rows="1" widths="95 95 95 95 95 95 95 " heights="12 50 50 50 50 50 50" dont-break-rows="true">
<tbody>
<% rows.forEach((row, rIdx) => { %>
<tr>
<% row.forEach((clm, cIdx) => { %>
<td fill-color="<%= rIdx ? '' : '#e5e5e5' %>">
<text font-size="8" bold="true"> <%= clm %> </text>
</td>
<% }) %>
</tr>
<% }) %>
</tbody>
</table>Just to break a line
<br/><img src="<%= image_data %>" width="100" height="100" fit="100 100"/><hr/>Use the attribute print-if and pass a boolean value to include this elements (and it's children or not).
Note - that the inner content is still rendered with ejs, so the variables need to be defined.
Supported fonts are:
- Avenir
- Geo
- Roboto