# Evidence BI-as-Code SQL and Markdown Analytics Framework

> Evidence is an open-source framework for building data products with SQL and Markdown. It generates interactive dashboards and reports as static sites, providing a code-driven alternative to drag-and-drop BI tools with version control and reproducibility built in.

- Skill: `agentskillexchange/evidence-bi-as-code-sql-and-markdown-analytics-framework` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/evidence-bi-as-code-sql-and-markdown-analytics-framework`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/evidence-bi-as-code-sql-and-markdown-analytics-framework/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/evidence-bi-as-code-sql-and-markdown-analytics-framework

---


# Evidence BI-as-Code SQL and Markdown Analytics Framework

Evidence is an open-source framework for building data products with SQL and Markdown. It generates interactive dashboards and reports as static sites, providing a code-driven alternative to drag-and-drop BI tools with version control and reproducibility built in.

## Installation

Requirements and caveats from upstream:
- See docs for [other install options](https://docs.evidence.dev/getting-started/install-evidence) (CLI, Docker, etc)

Basic usage or getting-started notes:
- **SQL statements** inside markdown files run queries against your data sources
- Download the [Evidence VSCode Extension](https://marketplace.visualstudio.com/items?itemName=Evidence.evidence-vscode)
- Open the Command Palette (F1) and enter Evidence: New Evidence Project

- Source: https://github.com/evidence-dev/evidence
- Extracted from upstream docs: https://raw.githubusercontent.com/evidence-dev/evidence/HEAD/README.md

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/evidence-bi-as-code-sql-markdown-analytics/)