Markwhen File Sync

This is an Obsidian plugin.

Synchronize Properties from your Obsidian notes with Markwhen timeline files.

Features

• Bidirectional synchronization
• Customizable grouping and sorting
• Flexible filtering options
• Auto-sync capability
• Status tag support

A possible use case is goal planning, where you can visualize projects and milestones with Markwhen, see for more informations my Medium-Article.

Installation

1. Open Obsidian Settings
2. Search for "Markwhen File Sync"
3. Install and Enable

Settings

1. Set the timeline file path to the path to the markwhen-timeline (include .mw)
2. Set the notes folder path to the path to the folder in which you have your notes, which you want to synchronize with the Markwhen-Timeline-File. Leave this blank to sync the entire vault.
3. Enable or disable the bidirectional synchronization.
   • if you enable it, then the date and endDate will synchronize from the notes to the timeline and the opposite direction
   • if you disable it, then the synchronization will synchronize only from tthe notes to the timeline
4. In the next step you have to set the name of the tag-property in your notes (usually tags)
5. Then choose tags which are required for the notes (currently you can't leave it empty, I'll modify it as soon as possible)
6. Additionally you can choose a property to group the files (for each different value of this property it is another group)
7. So you can also choose a property, such that the value of this is a tag to the Markwhen-Events in the timeline-note (you can leave it empty)

The format of the properties for the dates in the notes are based on the format from Full Calendar, so the start-date is: date and the end-date is: endDate.

The other settings are less important and should be self-explanatory

Notes:

• The plugin preserves an existing header block at the top of your Markwhen file. If you set a Header in settings, that value is used; otherwise the existing header is kept.
• Timeline events with month-only or year-only dates (e.g., 2025-06 or 2025) are supported; the plugin expands these to the start/end of the corresponding month/year according to your configured date format.

Usage

To use the synchronization you have to create notes in the notes-folder. For example:

If you already have a Markwhen timeline note, you can toggle synchronization using the Sync Timeline button in the left sidebar.

So than you have the synchronisation between the notes and the timeline-note. Only the dates will synchronize, the tags as well as the groups are not synchronized.

Example

You have this notes:

and So than you can toggle the synchronization: Than the markwhen-note going to be updated: and you can see the timeline:

Support

If you encounter any issues or have suggestions, please open an issue on GitHub.

License

MIT License