This is a library to call from your Perl code to create tables in PDF documents, using either PDF::Builder, or the older PDF::API2.
PDF::Table is a Perl library to format tables for insertion into PDF documents, using either the PDF::Builder or the PDF::API2 PDF-creation libraries, called from a Perl program. The PDF library (e.g., PDF::Builder) makes certain objects available to PDF::Table, as well as providing support services, and handles the overall PDF creation task. PDF::Table is called from within that library, to place tables of specific layout at the current active place on a document page. Tables may split across pages.
Note that PDF::Table, unlike PDF::Builder or PDF::API2, does not provide a set of low-level building blocks, but rather, is an all-in-one "table" call with very complex and flexible input. The table layout capability is a bit richer than that found in HTML/CSS, with a great deal of control over row, column, and cell properties, as well as rule and border formatting. With PDF::Builder as the underlying engine, PDF::Table cell content may be defined using Markdown or HTML markup languages. However, note that PDF::Table itself does not use HTML tag markup, nor does PDF::Builder currently support HTML table tags! The only way to put a table into a document is to invoke PDF::Table.
The documentation can be built from the Perl source, but is provided here for your convenience. The examples can be built by running the Perl sample code in the examples/ directory, but are provided here so you can browse the output to see what example may show what you're looking to do. Then you can look in the Perl code to see how to do it.