# tbls

Auto document databases.

Source: [Console review](<https://console.dev/tools/tbls>)

Website: [https://github.com/k1LoW/tbls](<https://github.com/k1LoW/tbls>)

Profile updated: 2026-10-16

Category: [Database management](<https://console.dev/tools/categories/database-management>)

## Supported tech stack

Research checked: 2026-10-11

### Integrates with

- Docker (Integration)
- PostgreSQL (Integration)

### Written in

- Go (Language)

Source: [Research source](<https://github.com/k1LoW/tbls>)

Documented compatibility; coverage may be incomplete. Written in describes implementation, not user-project language support.

Database documentation tool is written in Go, documents PostgreSQL and distributes Docker images.

## Console’s review — 2023-02-16

Reviewed: 2023-02-16

Author: [David Mytton](<https://console.dev/about#david-mytton>)

Citation: [This review](<https://console.dev/tools/tbls#review_0c258004751f274a25c2d0039331f53c9258dc3662feb3b4fa03174efeb6504a>)

### What we like

Single binary outputs Markdown documentation of your whole database (PG, MySQL, MariaDB, SQLite, BigQuery, & others) with one command. Configurable output format (Markdown, DOT, Mermaid, JSON, even Excel). Can diagram relationships. Includes linting function e.g. require comments. Can diff actual vs documented.

### Tradeoffs

It’s a documentation tool, not for migrations or actually creating the tables from scratch from the docs. Limited support for stored procedures and functions.

This review reflects Console’s assessment at publication on 2023-02-16. Features and limitations may have changed since the review date.

## Is tbls a fit?

Based on [Console’s review published on 2023-02-16](<https://console.dev/tools/tbls#review_0c258004751f274a25c2d0039331f53c9258dc3662feb3b4fa03174efeb6504a>).

Summary updated: 2026-10-16

### Who it’s for

Database developers should consider this tool for documentation tasks

### Why consider it

It can output Markdown documentation of a whole database with one command

### Keep in mind

It has limited support for stored procedures and functions

[Selection criteria](<https://console.dev/selection-criteria>) · [About Console](<https://console.dev/about>) · [Browse tools](<https://console.dev/tools>)
