What is Evidence?
Evidence is a web framework for data analysts. It’s an open source, code-based alternative to drag-and-drop business intelligence tools.
Motivation
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:
- SQL statements inside markdown files run queries against your data warehouse
- Charts and components are rendered using these query results
- Templated pages generate many pages from a single markdown template
- Loops and If / Else statements allow control of what is displayed to users
Pre-requisites
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.
- Message us on Slack
- Open an issue on Github
- See all the charts and components.
If there's anything you find difficult in the docs, please open an issue or reach out to us on Slack.