Skip to content

mihaiconstantin/bujo

Repository files navigation

Bullet Journal Markdown Workflows

GitHub release (latest by date) Repository Status GitHub issues Visual Studio Marketplace Downloads GitHub Repo stars

BuJo is a VS Code extension that adds syntax highlighting for Bullet Journal entries and provides convenient commands, snippets, keybindings, and more for managing tasks and notes in Markdown. It works best in combination with Dendron or Foam for an awesome way to turn your text editor into a full-fledged personal knowledge management and productivity system.

Features

Syntax Highlighting

At the highlighting syntax level, BuJo parses the text written in Markdown files for specific patterns and allows arbitrary colors to be mapped to different parts of a BuJo entry. Out of the box, BuJo provides highlighting for the standard Bullet Journal entries proposed by Carroll (2018). It also provides a way to select and colorize markdown table grids, and tasks and time records within tables.

BuJo Entries

BuJo Syntax Highlighting Feature

Time Blocking

Time Blocking Feature

Time Tracking

Time Tracking Feature

Task Management

BuJo goes beyond syntax highlighting and taps into time tracking and time blocking methodologies (e.g., Newport, 2016). To this end, BuJo proposes commands and keybindings to effortlessly update task statuses, plan working days, and track the time spent on tasks.

Name Description Context
bujo.symbol.setMigratedForward BuJo: Set Migrated Forward entry
bujo.symbol.setMigratedBackward BuJo: Set Migrated Backward entry
bujo.symbol.setCompleted BuJo: Set Completed entry
bujo.symbol.setOpened BuJo: Set Open entry
bujo.symbol.setStarted BuJo: Set Started entry
bujo.symbol.setDropped BuJo: Set Dropped entry
bujo.scheduler.scheduleEntry BuJo: Schedule Entry time tracking
bujo.tracker.recordTime BuJo: Record Time time tracking
bujo.tracker.calculateEntryTime BuJo: Calculate Entry Time time tracking



Check out the guide at bujo.mihaiconstantin.com for an overview of what BuJo can do.



Release Notes

See the CHANGELOG file.

Contributing

Any contributions, suggestions, or bug reports are welcome and greatly appreciated.

Roadmap

For planned features, please visit our project page. Any ideas and discussions are welcome!

License

BuJo is licensed under the MIT license.

References

  • Carroll, R. (2018). The bullet journal method: Track the past, order the present, design the future. Penguin.
  • Newport, C. (2016). Deep Work: Rules for Focused Success in a Distracted World. Hachette UK.