Skip to content

Synchronize properties from your Obsidian notes with a Markwhen timeline file.

License

Notifications You must be signed in to change notification settings

rpj-07/markwhen-file-sync

Repository files navigation

Markwhen File Sync

This is an Obsidian plugin.

Synchronize Properties from your Obsidian notes with Markwhen timeline files.


Bugs

Currently there exists a Bug with the date format from the Markwhen-Timeline, so in the past this was "YYYY-MM-DD", but currently there are sometimes different formats. I'll fix it as soon as possible


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

Usage

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

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: Screenshot 2025-01-30 172624

and Screenshot 2025-01-30 172604 So than you can toggle the synchronization: image Than the markwhen-note going to be updated: Screenshot 2025-01-30 172701 and you can see the timeline: Screenshot 2025-01-30 172724

Support

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

License

MIT License

About

Synchronize properties from your Obsidian notes with a Markwhen timeline file.

Resources

License

Stars

Watchers

Forks

Packages

No packages published