Skip to content

An [Obsidian](https://obsidian.md/) plugin to change task status and append text with hotkeys and right-click context menu.

License

Notifications You must be signed in to change notification settings

wenlzhang/obsidian-task-marker

Repository files navigation

Task Marker

GitHub release (Latest by date) GitHub all releases

An Obsidian plugin to change task status and append text with hotkeys and right-click context menu.

Features

  • Create tasks
    • Mark list items with [ ]
    • Optionally append text such as 📝 2023-01-01
  • Complete and cancel tasks
    • Mark tasks with [x] and [-]
    • Optionally append text such as ✅ 2023-01-01
  • Mark tasks
    • Mark tasks with statuses such as [>] and [/]
    • Mark individual task statuses with hotkeys
    • Optionally append text such as ❎ 2023-01-01
  • Cycle tasks
    • Cycle among configured statuses such as [x], [-], [>] and [/]
    • Reversely cycle among configured statuses
    • Include list item as the first cycled status 📝 2023-11-06
      • A toggle is added for selecting whether to include the list item as the first cycled status or not.
  • Cycle tasks among additional lists of statuses 📝 2023-11-04
    • E.g., list 1 x->/ for task execution status
    • E.g., list 2 ?!biI for task importance
    • E.g., list 3 pcud for task pro/con/up/down
  • Append text
    • Command to append text such as 📝 2023-01-01 to any line
    • Command to append text such as ✅ 2023-01-01 to any line
    • Command to append text such as ❎ 2023-01-01 to any line
  • Append text automatically 📝 2023-03-04
    • Automatically append text according to task/line status

demo

Miscellaneous

  • Support operating on items that start with -+* 📝 2023-07-24
  • Retain cursor location when operating on tasks 📝 2023-11-07
    • The cursor location is set with respect to text, excluding item/task prefix.
    • The behaviour is the same as the default Obsidian command Cycle bullet/checkbox.

Usage

How to use

See Usage for details.

How to configure

Task Marker uses moment.js to format the date and time to be appended. In addition, square brackets are needed to surround the content that is not part of the format string.

  • For example, if [completion::2023-01-01] is the desired text to be appended, then [[completion::]YYYY-MM-DD[]] needs to be configured in settings.

See Setting for more detailed settings.

How to install

Install the plugin from the Obsidian Community Plugins store:

  1. Go to Settings > Community plugins and disable "Restricted mode"
  2. Click "Browse" to search for plugins and type "task marker"
  3. Select Task Marker and click "Install"
  4. Enable Task Marker and configure it as desired

Resources

See Resource for details.

Development process

You can see how this plugin is developed starting from scratch as follows:

Credits

Support me

Buy Me a Coffee at ko-fi.com

About

An [Obsidian](https://obsidian.md/) plugin to change task status and append text with hotkeys and right-click context menu.

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Languages