template-render

n8n node: render a Word (.dotx) or PowerPoint (.potx) template + Markdown/doc-JSON into a .docx/.pptx

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.5
Author: vission

Documentation

n8n-nodes-template-render

Custom n8n node that renders a Word (.dotx) or PowerPoint (.potx) template plus
Markdown or doc JSON into a finished .docx / .pptx, preserving the template's
styles, theme, headers/footers, page setup, master and layouts. Usable as an AI Agent tool
(usableAsTool: true).

Parameters

Parameter Description
Template Source URL (downloaded via httpRequest) or Binary Property from the input item
Template URL / Template Binary Property Where to read the .dotx/.potx from
Content Markdown, or doc JSON { title, slides: [{ title?, blocks: Block[] }] }
Input Format auto (default), markdown, doc
Output Format auto (infer from template), docx, pptx
Fallback Title Used when the content has no title (Markdown without an H1)
Output Binary Property Binary property for the rendered file (default data)

Block ∈ heading{level,text} · paragraph{text} · bullets{items[]} · numbered{items[]} ·
table{headers[],rows[][]} · quote{text} · code{text} · divider.

Output: one item per input with json: { ok, format, title, fileName, mimeType, sizeBytes }
and the file in binary[<Output Binary Property>]. With Continue On Fail enabled, failing items
return json: { ok: false, error }.

Develop

npm install
npm run build      # tsc -> dist/, copies the icon
npm test           # core render, node execute(), real-HTTP e2e
npm run samples -- samples "../example templates/Deltek PPT Template - July 31.potx"

After any rendering change, open the files in samples/ in Word/PowerPoint to confirm they are
not corrupt — in-process asserts have missed real corruption bugs before.

Install into n8n

  • Community node: in n8n go to Settings → Community Nodes → Install and enter
    n8n-nodes-template-render.
  • Self-hosted custom dir: copy/npm install the package into ~/.n8n/custom/ (or the dir in
    N8N_CUSTOM_EXTENSIONS) and restart n8n.

pizzip is the only runtime dependency.

Implementation notes

  • nodes/TemplateRender/core/ is the proven prototype renderer, unchanged except that
    zip.ts now wraps pizzip (DEFLATE output, directory entries skipped on read).
  • Preserved OOXML fixes: slides end with <p:clrMapOvr><a:masterClrMapping/></p:clrMapOvr>;
    ppt/notesSlides/* and their content-type overrides are removed; DOCX keeps the trailing
    <w:sectPr>; template content types are flipped to document/presentation.

Known limitations

  • Tables in PPTX are flattened to pipe-separated text (native PPTX tables = future work).
  • Inline Markdown (**bold**, links) is rendered as plain text.
  • PPTX content slides all use one chosen layout (prefers a "Title and Content" layout).

Discussion