模板

title: ""
graphType: default
dateRangeValue: 10
dateRangeType: LATEST_MONTH
startOfWeek: 1
showCellRuleIndicators: false
titleStyle:
  textAlign: left
  fontSize: 22px
  fontWeight: normal
dataSource:
  type: PAGE
  value: ''
  dateField:
    type: FILE_MTIME
  filters: []
fillTheScreen: false
enableMainContainerShadow: false
cellStyleRules:
  - id: default_b
    color: "#0d4429ff"
    min: 1
    max: "3"
  - id: default_c
    color: "#1c753cff"
    min: "3"
    max: 5
  - id: default_d
    color: "#26a641ff"
    min: 5
    max: "20"
  - id: default_e
    color: "#3ad353ff"
    min: "20"
    max: 999
mainContainerStyle: {}
cellStyle:
  minWidth: 13px
  minHeight: 13px
 
title: ""
graphType: month-track
dateRangeValue: 3
dateRangeType: LATEST_MONTH
startOfWeek: 1
showCellRuleIndicators: false
titleStyle:
  textAlign: left
  fontSize: 22px
  fontWeight: normal
dataSource:
  type: PAGE
  value: ""
  dateField:
    type: FILE_MTIME
  filters: []
fillTheScreen: false
enableMainContainerShadow: false
cellStyleRules:
  - id: default_b
    color: "#0d4429ff"
    min: 1
    max: "3"
  - id: default_c
    color: "#1c753cff"
    min: "3"
    max: 5
  - id: default_d
    color: "#26a641ff"
    min: 5
    max: "20"
  - id: default_e
    color: "#3ad353ff"
    min: "20"
    max: 999
mainContainerStyle: {}
cellStyle:
  minWidth: 13px
  minHeight: 13px
 

English | 中文文档

What

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

buy me a coffee

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 note 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

Theme

  • Git Style

alt text

  • Month Track

alt text

  • Calendar

alt text

Features

  • diverse views, support week-track(default), month-track, and calendar view.
  • personalized style, you can configure different cell colors and fill cells with emojis.
  • use fixed date range or latest date to generate graph
  • interactive charts, you can customize cell click event, hover to show statistic data
  • simply integrate with DataviewJS, use contribution graph’s api to dynamically render charts

How to modify graph?

Jut click the edit button at top right corner

Alt text

Configurations

namedescriptiontypedefaultsamplerequired
titlethe title of the graphstringContributionsfalse
titleStylethe style of the titleobjectfalse
daysMaximum number of days for the chart to display (starting from today)number365true if miss fromDate and toDate
fromDateThe start date of the chartdate, format yyyy-MM-dd2023-01-01true if miss days
toDateThe end date of the chartdate, format yyyy-MM-dd2023-12-31true if miss days
querydataview query syntax, contribution graph will use it to count filesstringtrue
dateFieldDate attributes of files used for data distributionstringfile.ctimecreateTimefalse
startOfWeekstart of weeknumber0false
showCellRuleIndicatorsControl the display and hiding of cell rule indicator elementsbooleantruefalse
cellStyleRulescell style rulearrayfalse

More Usage Guid