# Sayi/poi-tl

Generate awesome word(docx) with template

Repository: https://github.com/Sayi/poi-tl
Canonical: https://ross.abutalabs.com/products/poi-tl
Homepage: https://deepoove.com/poi-tl/
Language: Java
License: Apache-2.0
License Family: permissive
Topics: word, poi, template, java, docx, export, markdown
Last push: 2026-08-08T05:24:51+00:00

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 96, release rhythm 8, longevity 100
- inputs: {"age_days": 4184, "days_push": 25, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5140, forks 1130 (observed 2026-08-28T04:09:11.131314+00:00)

## What it is
poi-tl is a Word (docx) template engine for Java built on Apache POI, generating new documents from Word templates and data. It is a logic-less template engine supporting text, images, tables, charts, loops, conditionals, Markdown, comments, and custom plugin functions.

## Use cases
- generate word documents from templates in java
- export data to docx reports
- fill word template placeholders with data
- generate invoices or certificates as docx
- render markdown to word document
- add word export to my application
- loop table rows in a docx template

## When to choose
- you need to generate styled Word documents from templates in a Java application
- you want template-driven document generation preserving Word styles (WYSIWYG)
- you need rich features like charts, tables, loops, conditionals, comments, and attachments in docx output

## When to avoid
- you need to generate non-Word formats like PDF or HTML directly
- you are not on the JVM and cannot use Java libraries
- you need complex logic inside templates rather than in code

## Facets
- artifact type: library
- maturity: active
- function: templating, pdf, plugin-system, developer-tools
- domain: developer-tools, files, documentation
- platform: jvm, cross-platform
- tags: word, docx, template-engine, apache-poi, document-generation, report-generation, java-library, automation

## Member repositories
- Sayi/poi-tl (main) score 66

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:11.131314+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:02:00.150220+00:00, confidence not recorded.
  - readme: https://github.com/Sayi/poi-tl (fetched 2026-08-28T04:09:11.131314+00:00, sha d47d2a1a0dfd)
  - homepage: https://deepoove.com/poi-tl/ (fetched 2026-08-29T08:56:29.030681+00:00, sha 079491388476)
  - site_page: http://deepoove.com/poi-tl/1.6.x (fetched 2026-08-29T08:56:29.055675+00:00, sha a0f962bc14e3)
  - site_page: http://deepoove.com/poi-tl/1.5.x (fetched 2026-08-29T08:56:29.058047+00:00, sha 20cc2d4b4280)
  - site_page: http://deepoove.com/poi-tl/1.11.x (fetched 2026-08-29T08:56:29.035026+00:00, sha fbf3985468dc)
  - site_page: http://deepoove.com/poi-tl/1.10.x (fetched 2026-08-29T08:56:29.039224+00:00, sha c8530279ef36)
  - site_page: http://deepoove.com/poi-tl/1.9.x (fetched 2026-08-29T08:56:29.046968+00:00, sha f53177643a68)
  - site_page: http://deepoove.com/poi-tl/1.8.x (fetched 2026-08-29T08:56:29.050137+00:00, sha 554913cb50a7)
  - site_page: http://deepoove.com/poi-tl/1.7.x (fetched 2026-08-29T08:56:29.052989+00:00, sha 4dedd06dfc28)
- Data as of 2026-08-30T08:39:29.467469+00:00.