Skip to main content

What is Evidence?

Evidence is an open source, code-based alternative to drag-and-drop business intelligence tools.


Our goal is to enable data analysts to deliver reliable, clear, and valuable reporting products driven by live data.

We believe that the best way to achieve that goal is to equip analysts with a higher leverage workflow than dragging-and-dropping charts and filters onto a dashboard.

Evidence provides:

  • Code-driven workflows: Use your IDE, version control, and CI/CD tools
  • First-class text support: Add context, explanation and insight to your reports using markdown
  • Control structures: Use loops, conditionals, and parameterized pages to generate content from data
  • Performance: Evidence projects build into fast and reliable web application
  • Lightweight setup: Install locally and start building reports immediately

To get started, install Evidence.

How does Evidence work?

Evidence renders a BI website from markdown files:

  1. SQL statements inside markdown files run queries against your data warehouse
  2. Charts and components are rendered using these query results
  3. Templated pages generate many pages from a single markdown template
  4. 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.