Wordflow Tracker

中文文档 | English

Introduction

WorkFlow Tracker is a lite plugin that track your edits on each note and automatically record these edits statistics to your periodic note, like your daily note.

Core Features

• Tracking the number of edits, editied words per note. This will reflect on the status bar at the bottom of note.

• Record the modified data automatically when the note is closed. Alternatively, use command or button to record all notes.

• Display changes in a bar style to show the portion of original contents v.s. modified contents.

• Record edited statistics such as total words you edited today, to the YAML(Frontmatter) of daily note. Other plugins such as heatmap could use these metadata to generate analysis.

  

• Customization of which data to be recorded with ${dataName}, see in Supported String Interpolations below.

• Customization of how the data to be recorded, like inserting a table or a list to the specified position of your note.

How does this plugin collect data?

We fetch the edit statistcs by access the history field of Obsidian editor, which is the place to store the undo/redo history of Obsidian.

• No extra history database is created, thus don't worry about the performance burdens in large vault.
• No extra data file is created or exposed. This resolves the privacy concerns.

All statics are fetched by diectly reading the Obsidian data, without adding additional thread to record the data, which means that enabling the recording will bring almost no performance loss or extra RAM occupation.

The temporary edit stats collected by the plugin are destroyed after recording to your note, and the Obsidian will destory the history data after you close the application.

Guide for beginners

Step 1: Download and install the plugin.

Step 2: Enable the plugin in Obsidian > Settings > Community plugins.

Step 3: In Wordflow Tracker settings, specify your periodic note folder for placing your periodic notes, in which the edit stats will be saved.

Now the plugin will automatically track the edits you made and display them in the status bar. The edits stats will also be recorded to your periodic note, when any one of the following is met:

1. you switch from editing mode to reading mode in Obsidian;
2. you close a tab of notes after editing them;
3. you manually click the button "Record wordflows from edited notes" in the left ribbon of Obsidian;
4. you manually run the command "Record wordflows from edited notes to periodic notes" in Obsidian;
5. the automatic recording interval is timed out, which could be set in the setting of Wordflow Tracker plugin, to record all edited notes.

Note: the tracker will be set to 0 once the note is recorded.

Advanced guide for customization

Apply templates to newly created notes before recording

Make sure your template will be applied to notes under the same periodic note folder.

If your newly created notes will be renamed by other plugins, such as Templates(core plugin) or Templater(community plugin), make sure that the name that other plugin specified is the same as periodic note format

Customize which data to be recorded

In wordflow recording syntax, you can add or delete the data in one of the following formats:

• Table:

  Open any note in Obsidian, and add a blank table with:

  
  | |
  |-|
  | |
  

  Then, specify the name in heading for ${modifiedNote}, such as "Note Name" and add "${modifiedNote}" to the row.

  

  Now click the 'add column after' button, and specify the new heading names and any string interpolations you would like.

  

  Lastly, select and copy the whole table, and paste it into Wordflow Tracker settings.

  

  Note: ${modifiedNote} must exist in the table syntax, or the recorder will have trouble merging the existing data of note with the new data

• Bullet List:

  Add a linebreak, press the tab key for proper spacing, and specify any name you expect for this data.

  Lastly, add a string interpolations like "${docWords}"

  

  Note: ${modifiedNote} must exist in the bullet list syntax, or the recorder will have trouble merging the existing data of note with the new data

• Metadata:

  Just like adding a metadata in "source mode", you can add a property name ends with ':', and a string interpolations after it, like "${totalWords}"

Record edit stats to both note content and yaml(frontmatter)

In plugin settings, create a recorder by clicking the add button:

Then, adjust the perodic note folder and note format to the same as the other recorder, to record on the same note.

Lastly, adjust the record content type to a different one.

Note that you should avoid having the same record content type of 2 recorders that target on the same note. For example, avoid having one recorder which inserts table to the bottom of today's daily note, while having the other recorder which inserts table to a custom position of today's daily note.

Record edit stats to a dynamic folder

You can record edit statistics to not only a static folder, such as "Daily Notes/2025-03-23.md", but also on a dynamic folder like: "Daily Notes/2025-03/2025-03-23.md".

For details regarding how to implement this, see Enable dynamic folder

Please also ensure that this folder is the same folder where templates from other plugin will be applied.

Settings documentation

Recorder

• Create: Create a new recorder so that the edit stats in tracker will be additionally recorded. Common usages are as followed:

  • Create a recorder for another periodic note: current recorder will record to daily note, and you create an additional one to record to monthly note.

  • Create a recorder for a different recording type: current recorder will record edits per note as table rows to your daily note, and you create another recorder to record total edits to the YAML of daily notes.

    

• Rename: Rename your recorders.
• Delete: Delete the current recorder and abandon its settings.

Recorder Basics

• Periodic note folder: Set the folder for daily notes or weekly note to place, which should correspond to the same folder of Obsidian daily note plugin and of templater plugin(if installed).

  • Enable dynamic folder: Record the note to a dynamic folder rather than a static folder. If enabled, the folder must be in a moment compatible format.

    Dynamic folder format	Corresponding folder in vault	Periodic note format	Note path in vault
    [Daily Notes/]YYYY-MM	Daily Notes/2025-03	YYYY-MM-DD	Daily Notes/2025-03/2025-03-21.md
    [Monthly Notes/]YYYY	Monthly Notes/2025	MMM YYYY	Monthly Notes/2025/Mar 2025.md

• Periodic note format: Set the file name for newly created daily notes or weekly note, which should correspond to the same format setting of Obsidian daily note plugin and of templater plugin(if installed).

Recording Settings

• Record content type: Select a type of content to record on specified notes. Currently, table and bullet list are supported.
  • Note: when using a table format, the modified note must be at the first column.
• Insert to position: If using a custom position, the start position and end position must exist and be unique in periodic note! Make sure your template is correctly applied while creating new periodic note.
• Wordflow recording syntax: Used for customizaing recording content. The regular expressions are supported with '${modifiedNote}', you can also generate link to the note by using a '[[${modifiedNote}]]'.

Supported String Interpolations

String Interpolation	Description	Compatible Record Types	Example	Note
${modifiedNote}	the Obsidian path to modified note	table, bullet list	Daily Notes/2025-03-23.md	should always be put at the first colomn in a table, or the parent element in a bullet list.
${editedTimes}	the number of edits in a period per note.	table, bullet list	100	in Obsidian rule, inputted contents whose intervals are less than 0.5 second will be considered one edit. Each edit can be undone by pressing 'ctrl' + 'z', or redone by pressing 'ctrl' + 'shift' + 'z'.
${editedWords}	the number of words you edited in a period per note.	table, bullet list	550	equals to addedWords + deletedWords
${changedWords}	the net change of words in a note	table, bullet list	150	equals to addedWords - deletedWords
${deletedWords}	the number of words you deleted in a period per note.	table, bullet list	200
${addedWords}	the number of words you added in a period per note.	table, bullet list	350
${docWords}	the number of words per document, by the end of last recording.	table, bullet list	1000	includes words in YAML(Fromtmatter), which is not included in Obsidian word count core plugin.
${editedPercentage}	(beta testing) the rate of edited words to the total words(edited + original), in a period of editing per note. Very useful when you want to track if the edits are little changes or huge efforts	table, bullet list	55%	the content is html format, and will be styled to a string. (Using string directly is abandoned due to the growing loss of accuracy with the recorder updates this string. )
${statBar}	(beta testing) the portion of original words, deleted words and added words in html format. Very useful when you want to track if the edits are little changes or huge efforts	table		the content will be styled to a svg bar, whose color can be customized in styles.css. Example uses the portion of 450:200:150
${lastModifiedTime}	the last modified time of your note that is recorded to periodic note, you can specify the format of this item in plugin settings	table, bullet list	2025-03-23 16:00
${totalEdits}	the total number of edits of all notes you edited in a period.	metadata	200	can be used for other plugins, such as generating a heatmap
${totalWords}	the total number of edited words of all notes you edited in a period.	metadata	2000	can be used for other plugins, such as generating a heatmap

Development Roadmap

See Development Roadmap for known issues and planned features!

What to know how this project is built? Or wanna collaborate on this plugin? See details at https://deepwiki.com/LeCheenaX/WordFlow-Tracker

Installation

Install in Obsidian

Open obsidian settings > community plugins > browse，in the pop up windows, search for Wordflow Tracker, and click the install button.

After installed, click the enable button to start the experience.

Manually installing the plugin

Copy over main.js, manifest.json, styles.css to your vault VaultFolder/.obsidian/plugins/wordflow-tracker/.

Install via BRAT

See BRAT docs.

Similar plugins

This lite plugin tries to offer unique experience for tracking edits periodically with least obstacles. However, you can try the following alternatives if interested:

• Obsipulse plugin
• Daily File Logger