Skip to content

sharkmu/obsidian-journal

 
 

Repository files navigation

Journals for Obsidian

Manage your journals in Obsidian knowledge base.

  • Calendar based journals (daily, weekly, monthly, quarterly and yearly notes)
  • Interval based journals (like finantial quarters or sprints)
  • You can configure many different journals based on your needs
  • Every note type configured separately (path to store, templates etc)
  • Variables to insert journal related data into paths/note name/template content.
  • Creating current journal notes on vault open
  • Opening journal note on startup
  • Code blocks for journal notes for easier navigation

Instalation

Follow the steps below to install Tasks.

  1. Search for "Journals" in Obsidian's community plugins browser
  2. Enable the plugin in your Obsidian settings (find "Journals" under "Community plugins").
  3. Check the settings. Configure journals that you need.

Supported variables

There variables can be used in note name template, note storage path, content of template note.

  • {{journal_name}} - name of journal note belongs to
  • {{note_name}} - name of note
  • {{start_date}} - first day of week, month, quarter, year or interval depending on note type, formatted using date format from settings, format can be overridden using following syntax {{start_date:format}} where format is string using Moment.js format rules (like {{start_date:YYYY-MM-DD}})
  • {{end_date}} - last day of week, month, quarter, year or interval depending on note type, formatting rules are the same as in {{start_date}}
  • {{date}} - alias to {{start_date}}
  • {{index}} - avaliable for interval based journals indicating index of interval (like financial quarter or spring number)

Supported code blocks

For easier navigation plugin provides code blocks that can be inserted into note content.

```calendar-nav

```

Navigation code block helps navigating relative to current note.

Example look for daily note:

Daily note nav


```interval-nav

```

This block is similar to previous one just for interval based journals.

Example look for interval note (configured as 1 week sprints):

Sprint note nav


```calendar-timeline

```

Timeline code blocks helps navigating daily notes in bigger periods (like week, month, quarter or year). By defauls daily and weekly notes show week timeline, monthly note - month timeline, quarter note - quarter timeline and yearly note - calendar timeline. This can be changed using mode param.

```calendar-timeline
mode: month
```

Sample week timeline

Week timeline

Sample month timeline

Month timeline

Quarter and Calendar timeline repeat month timeline for every month in quarter or year.

Contributing

Contributions via bug reports, bug fixes, documentation, and general improvements are always welcome. For more major feature work, make an issue about the feature idea / reach out to me so we can judge feasibility and how best to implement it.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 95.8%
  • CSS 2.8%
  • JavaScript 1.4%