Description

The Contribution Graph plugin is a powerful tool for Obsidian users to visualize and track their notes, habits, activity, and history. With this plugin, you can create interactive heatmap graphs that resemble GitHub's contribution charts. You can use it as a habit tracker, note tracker, or review report generator, and even customize the appearance with different themes and styles.

The plugin offers various features such as multiple graph types, personalized style options, customizable dates, and interactive charts. You can also integrate it with DataviewJS to dynamically render charts. The configuration options are flexible, allowing you to tailor the graph to your specific needs.

Whether you're looking to track your daily progress or review your past activity, the Contribution Graph plugin provides a visually engaging way to do so.

English | 中文文档

What

Contribution Graph is a plugin for obsidian.md which can generate interactive heatmap graphs like GitHub to track your notes, habits, activity, history, and so on.

Use Cases

Habit Tracker: Count the number of tasks you complete every day. Different numbers will be marked in different colors.
Note Tracker: Count the number of notes you create every day. Different numbers will be marked in different colors.
Review Report: Count your notes or tasks for a certain period of time and generate a heat map for a more intuitive review
and more...

Quick Start

Create empty note, then right-click
Select Add Heatmap options
Click the save button, and then a heatmap will be created in note.

Alt text

Themes

Git Style

alt text

Month Track

alt text

Calendar

alt text

Features

Multiple graph types, support week-track(default), month-track, and calendar view.
Personalized style, you can configure cell colors and fill cells with emojis.
Customizable dates,use fixed date range or latest date to generate graph
Interactive charts, you can customize cell click event, hover to show statistic data
Integrate with DataviewJS, use contribution graph's api to dynamically render charts

How to Modify Graph?

Just click the edit button at top right corner

Alt text

Configurations

name	description	type	default	sample	required
title	the title of the graph	string	Contributions		false
titleStyle	the style of the title	object			false
days	Maximum number of days for the chart to display (starting from today)	number		365	true if miss fromDate and toDate
fromDate	The start date of the chart	date, format yyyy-MM-dd		2023-01-01	true if miss days
toDate	The end date of the chart	date, format yyyy-MM-dd		2023-12-31	true if miss days
query	dataview query syntax, contribution graph will use it to count files	string			true
dateField	Date attributes of files used for data distribution	string	file.ctime	createTime	false
startOfWeek	start of week	number	0		false
showCellRuleIndicators	Control the display and hiding of cell rule indicator elements	boolean	true		false
cellStyleRules	cell style rule	array			false

Contribution Graph

Description

Reviews

Stats

Latest Version

Changelog

What's Changed

New Contributors

README file from

What

Use Cases

Quick Start

Themes

Features

How to Modify Graph?

Configurations

More Usage Guides

Similar Plugins