What is Evidence?

Evidence is an open source framework for building data products with SQL - things like reports, decision-support tools, and embedded dashboards. It's a code-driven alternative to drag-and-drop BI tools.

This docs site is an Evidence project.

Install Evidence with the VSCode Extension, or see other installation options.

How does Evidence work?

Evidence renders a BI website from markdown files:

  1. Data sources can include data warehouses, flat files and non-SQL data sources
  2. SQL statements inside markdown files run queries against data sources
  3. Charts and components are rendered using these query results
  4. Templated pages generate many pages from a single markdown template
  5. Loops and If / Else statements allow control of what is displayed to users


To use Evidence you need to know SQL. A knowledge of basic markdown syntax is also helpful.

Getting help

If you're trying out Evidence, and need some support we'd love to hear from you.

If there's anything you find difficult in the docs, please open an issue or reach out to us on Slack.