# GoodCharts

### Turn the data in your Obsidian notes into clear, interactive stories.

No spreadsheet detours. No chart software to learn. Keep your evidence, writing, and visuals together in one note.

![GitHub release](https://img.shields.io/github/v/release/Times0/good-charts?style=flat-square&color=7c3aed)
![MIT License](https://img.shields.io/badge/license-MIT-7c3aed?style=flat-square)

![GoodCharts scrolling through a page of real interactive chart examples in Obsidian](./docs/assets/full-page-demo.webp)

## See the story in your data

GoodCharts helps you:

- **Spot trends** while researching or taking notes
- **Compare evidence** without leaving Obsidian
- **Call out turning points** that matter to your story
- **Keep charts connected to their source data**
- **Ask an AI assistant** to create richer visuals for you

Ideal for journalists, students, researchers, writers, and anyone who thinks in notes—not dashboards.

## From table to chart in one click

Write or paste a simple table, then switch between the source data and an interactive chart. Your table stays intact and editable.

![An Obsidian table switching into an interactive chart](./docs/assets/toggle-showcase.webp)

Update a number in your note and the chart updates with it. Hover to explore values, then switch back to the table whenever you want to check the evidence.

## Answer real questions visually

**Are we moving toward the goal?**

![A weekly activation chart showing progress toward a goal](./docs/assets/simple-areachart_lineachart.webp)

**What changed—and what caused it?**

![A customer satisfaction chart highlighting the moments that changed the trend](./docs/assets/linechart-with-dots.webp)

**Where should we act first?**

![An opportunity map that compares ideas by impact and effort](./docs/assets/complex-chart.webp)

Compare outcomes, show goals, and mark important events—all beside the notes that explain them.

## Start in three steps

1. Install and enable GoodCharts in Obsidian.
2. Add a table to a note.
3. Open Reading view and select the chart button.

That is enough for your first chart.

## Want something more expressive?

Ask your AI assistant for a GoodCharts visual in plain language:

> “Turn these survey results into a chart and highlight the two biggest changes.”

The included [GoodCharts Agent Skill](./skills/goodcharts/SKILL.md) helps compatible AI assistants create custom charts safely while keeping everything readable in your note.

## Install

Until GoodCharts is available in Obsidian's Community Plugins directory, download the files from the [latest release](https://github.com/Times0/good-charts/releases/latest) and copy them to:

`<your-vault>/.obsidian/plugins/goodcharts/`

Reload Obsidian, then enable **GoodCharts** under **Settings → Community plugins**.

---

Have an idea or found a problem? [Open an issue](https://github.com/Times0/good-charts/issues).

Powered by [TanStack Charts](https://tanstack.com/charts/latest). Released under the [MIT License](./LICENSE).