TaskMark
Markdown-Based Schedule & Task Management VS Code Extension
Write your schedules and tasks in a .tmd file using Markdown formatting and visualize them instantly in Calendar or Timeline (Gantt chart) views.
Features
📅 Calendar View
Switch between three granularity levels to check your schedule.
- Monthly — Overview of the entire month
- Weekly — Horizontal view of the week
- Daily — Detailed schedule for a specific day
Interactions:
- Click a date cell → Jump directly to the Daily view for that day
< > Buttons → Navigate forward and backward in timeToday Button → Return to the current date- Saturdays are highlighted in blue, Sundays in red
📊 Timeline View (Gantt Chart)
Visualize schedule durations and project spans as a Gantt chart.
- Pan — Move smoothly in any direction by clicking and dragging
- Zoom — Use
Ctrl + Mouse Wheel to zoom in/out (from days to hours)
- Progress Bars — Group task completion rates are displayed visually on the bars
- Weekend Colors — Colored backgrounds corresponding to the calendar view
- Grouped schedules appear as a single connected bar, while standalone items with the same name appear as separate blocks on the same row
Categorize schedules and tasks visually with tags.
@tags
#Important: #e74c3c
#MTG: #3498db
#Dev: #2ecc71
@end
Define tag colors inside the @tags block. Undefined tags automatically receive a deterministic, generated color based on the tag name.
🔁 Recurring Schedules
Automatically expand recurring schedules. Tasks (- [ ] / - [x]) manage independent completion states and are ignored by repeat modifiers.
- 10:00-11:00 Weekly Sync @repeat(weekly) #MTG
- 09:00-10:00 Monthly Report @repeat(monthly, count:6) #Important
- 09:00 Morning Stretch @repeat(daily, until:2026-06-30)
- 14:00 Bi-Weekly 1on1 @repeat(every:2weeks, count:8) #MTG
| Modifier |
Description |
Example |
daily |
Every day |
@repeat(daily) |
weekly |
Every week |
@repeat(weekly) |
monthly |
Every month |
@repeat(monthly) |
every:Ndays |
Every N days |
@repeat(every:3days) |
every:Nweeks |
Every N weeks |
@repeat(every:2weeks) |
every:Nmonths |
Every N months |
@repeat(every:3months) |
until:YYYY-MM-DD |
End date |
@repeat(weekly, until:2026-06-30) |
count:N |
Occurrences |
@repeat(monthly, count:6) |
Options can be combined using commas. If not explicitly defined, recurrences default to 12 expansions.
@tags
#TagName: hex_color
@end
# YYYY-MM-DD
- HH:mm-HH:mm Schedule item #Tag
- HH:mm Schedule item with start time only
- Schedule item @repeat(weekly, until:2026-12-31)
- [ ] Uncompleted task #Tag
- [x] Completed task
> Group Name
> - 13:00-15:00 Schedule inside group #Tag
> - [x] Completed task inside group
> - [ ] Uncompleted task inside group
Syntax Reference
| Syntax |
Description |
Applies to |
@tags ... @end |
Tag color definition block |
— |
# YYYY-MM-DD |
Date header |
— |
- Text |
Schedule (Event) |
— |
- [ ] Text |
Uncompleted task |
— |
- [x] Text |
Completed task |
— |
HH:mm-HH:mm |
Time range (Start-End) |
Schedules |
HH:mm |
Start time only |
Schedules |
#Tag |
Tags (Multiple allowed) |
Both |
@repeat(...) |
Recurring items |
Schedules only |
> Group Name |
Group header |
— |
> - Item |
Items inside group |
Both |
Usage
- Open a
.tmd extension file.
- Run
TaskMark: Open View from the Command Palette (Ctrl+Shift+P).
- View the Calendar / Timeline interface in a new panel.
- Edit the
.tmd file side-by-side; the view will reflect changes in real-time.
Project Structure
TaskMark/
├── src/
│ ├── extension.ts # Extension entry point
│ ├── TaskmarkPanel.ts # Webview panel management
│ └── parser.ts # .tmd file parser
├── media/
│ ├── main.js # Webview frontend logic
│ └── style.css # Webview frontend styling
├── syntaxes/
│ └── tmd.tmLanguage.json # Syntax highlighting definitions
├── sample.tmd # Sample file
└── package.json
License
This project is licensed under the MIT License - see the LICENSE file for details.
