tbls
tbls: Open-source database documentation with diagrams, schema checks, and many export formats. Ranked #6 of 27 in Database Documentation Tools by our editors (8.6/10); pricing: Free plan; best for open-source teams using CI-based documentation.
At a glance
- Editor score8.6 / 10
- PricingFree plan
- Best forOpen-source teams using CI-based documentation
- Free planYes
- Paid fromFree
- Database coverageMulti_model
- Facts checked21 Sep 2026
Where it wins
- Exports schemas to Markdown, diagrams, images, JSON, YAML, and Excel
- Adds ER diagrams, schema comparison, configurable linting, and coverage metrics
- Runs on Windows, macOS, Linux, CI workflows, and Docker
Where it doesn't
- Command-line operation may not suit teams seeking a graphical workspace
- Self-hosted deployment places setup and maintenance with the team
- No AI features or paid tiers for expanded commercial functionality
Our verdict on tbls
tbls is an open-source command-line tool for documenting databases, written in Go. It connects to supported databases through DSNs and is aimed at developers and teams that keep database documentation in repositories and CI workflows. The tool generates GitHub Flavored Markdown, creates entity-relationship diagrams, and supports Windows, macOS, and Linux. Its self-hosted model also fits teams that want documentation generation to run within their own development and delivery environments.
Its strongest area is output and documentation depth. tbls can produce schemas in Markdown, DOT, PlantUML, Mermaid, SVG, PNG, JPG, JSON, YAML, and Excel formats, giving teams options for repository documentation, diagrams, structured exports, and spreadsheet-based reference material. It also supports table and column comments, labels, relations, and dictionary customization. Schema comparison can check a database against generated documentation or another database, while configurable linting rules and documentation coverage measurements help teams identify schema issues and incomplete descriptions.
The workflow is particularly suited to automation: tbls runs in CI workflows and is available as a Docker image, alongside source code, binaries, package managers, and Go installation. That makes it a practical choice for open-source teams that want repeatable documentation generation and checks around database changes. It is less suitable for organizations looking for a managed, graphical documentation service, paid-tier features, or AI-assisted workflows. Choose tbls when repository-based documentation, multiple export formats, schema quality checks, and self-hosted control matter most; choose an alternative when a visual workspace or managed commercial platform is the priority.
Your product? Our editors can test tbls in depth and publish a review, labelled as paid · from $149/mo →
tbls pricing
tbls fact sheet
| Free plan | Yes |
|---|---|
| Paid from | Free |
| Database coverage | Multi_model |
| Data lineage | Yes |
| Data dictionary | Yes |
| Schema history | Yes |
| Deployment | Self_hosted |
| Single sign-on | Not verified |
| Deployment | Self-hosted |
| Platforms | Windows, macOS, Linux |
| Support | Docs |
| Built for | Solo, Small business, Mid-market, Enterprise (editorial estimate) |
| Pricing | Free plan |
| Website | github.com |
| Facts checked | 21 Sep 2026 |
Alternatives to tbls
- DataedoA broad, governed data catalog with strong lineage and quality coverage at a high annual price.9.4
- AzimuttA broad toolkit for exploring, analyzing, designing, and documenting large mixed-model schemas.9.2
- SchemaCrawlerA free, open-source choice for automated relational database documentation and analysis.9.0
tbls vs the competition
Compare tbls with any tool side by side →
Used tbls? Be the first to review it
The editor score above is our own research. What this page doesn't have yet is a reader's view — what you used tbls for, what worked and what didn't. No stars are seeded and no review is paid for; an editor reads every one before it appears.
Write a reviewTwo minutes · verified accounts only · read by an editor before it appears
Featured on iTechGuides
tbls is listed in our Database Documentation Tools directory. Add the badge to your site — it links back to this page.
<a href="https://www.itechguides.com/products/tbls/"><img src="https://www.itechguides.com/best/badge/tbls.svg" alt="Featured on iTechGuides" width="230" height="46"></a>
Reviewed by iTechGuides Editors · Editorial team · Updated Oct 2026
Advertiser disclosure: iTechGuides is reader-supported. Vendors can pay for top positions in our rankings and for a place on other products' pages, and we may earn a commission when you click some links. Bought places stand at the number bought; this page and our disclosure say so. Paying vendors may get a fuller, more detailed review from our editors, and that review can change their score. How we rank.
Last updated · How we research and update