Markwhen Gantt

An Obsidian plugin that renders .mw and .markwhen files as interactive Gantt charts.

Features

• Native file support — .mw and .markwhen files open directly in Obsidian as Gantt charts
• Split view — source editor on the left, live chart on the right; toggle the Gantt panel with one click
• Zoom controls — zoom in, zoom out, or fit the full timeline to the view
• Owner filtering — filter tasks by owner using the toolbar buttons
• Clickable tasks — click any bar to see a detail panel with dates, duration, owner chips, tags, and notes
• Section dividers — sections are visually separated with labels and horizontal rules
• Milestones — single-date entries render as a diamond marker
• Drag to resize — drag the divider between editor and chart to resize both panels
• Settings — row height, bar height %, today line, bar labels, editor font size, and tab width

Installation

From the community plugins directory

1. Open Obsidian → Settings → Community Plugins
2. Turn off Restricted Mode
3. Click Browse and search for "Markwhen Gantt"
4. Install and enable

Manual install

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create a folder at <your vault>/.obsidian/plugins/markwhen-gantt/
3. Copy the three files into that folder
4. Open Obsidian → Settings → Community Plugins → enable Markwhen Gantt

Usage

Create a file with the .mw extension in your vault and click it. The plugin opens it in a split view — raw source on the left, Gantt chart on the right.

Click 📊 Show Gantt in the top-right corner to toggle the chart panel.

Supported syntax

title: My Project

#category: #94a3b8
#Alice: blue
#Bob: red

# Phase 1
2026-01-01/2026-03-31: Phase 1 #category
2026-01-01/2026-02-14: Design #Alice
  owner: Alice
  notes: Initial design work. Includes wireframes and review.
2026-02-15/2026-03-31: Development #Bob
  owner: Bob

# Milestones
2026-02-14: Design review #Alice
  owner: Alice

# Vacation
2026-03-01/2026-03-07: Vacation #Alice

Syntax	Description
title: ...	Chart title shown in the toolbar
#TagName: color	Assigns a color to a tag (blue, red, green, purple, orange, teal, pink, yellow, or any hex like #ff0000)
# Section name	Creates a labelled section with a divider
YYYY-MM-DD/YYYY-MM-DD: Label #tag	A task bar
YYYY-MM-DD: Label #tag	A milestone (renders as a diamond)
owner: Name or owner: [Name, Name]	Assigns one or more owners (used for filtering)
notes: ...	Adds a note shown in the detail panel

Owner filtering

Filters are built automatically from all owner: properties in the file. Click an owner's name in the toolbar to show only their tasks. Click again (or click "all") to reset.

Tags on a bar affect its colour only — they are independent from owners.

Zoom

Use the − and + buttons to zoom out and in. Click ⊡ Fit to auto-scale the timeline to fill the available width.

Settings

Click ⚙ in the standalone Gantt view toolbar to adjust:

• Row height
• Bar height (as % of row)
• Today line on/off
• Bar labels on/off
• Editor font size
• Tab width (2 or 4 spaces)

Global defaults can also be set under Settings → Markwhen Gantt in Obsidian's preferences.

License

MIT