Introduction

Markwhen is a markdown-like journal language. You write markdown-ish text and it gets converted into JSON which can then be rendered into a timeline or other view.

Use the editor at meridiem.markwhen.com or read more about the syntax.

Markwhen input

2025-04-09: Single date 2025-01-22 / 2026-10-24: Date range Dec 1 2025: Supports multiple date formats And longer descriptions

group Part one 2024-12-24: Christmas Eve 2024-12-25: Christmas endGroup group Part two 2024-12-31: New Year's Eve 2025-01-01: New Year's Day endGroup

2025-01-01: New Year's Day #holiday 2024-10-31: Scary time #haloween #holiday

2024: - [x] lose 70 pounds - [x] learn to write markwhen - [] build a house 2025: - [] gain 20 pounds - [] go to the moon - [] find a new place to eat

2025-01-01: New Year's Day - [] [Google](https://google.com) - [] [DuckDuckGo](https://duckduckgo.com) - [] [Bing](https://bing.com)

timezone: America/New_York 2025-01-01 12:00: New Year's Day

2025-01-01 every year for 10 years: Copy last year's resolutions to this year 2024-12-24 9am every 60 minutes x12: Check for Santa

title: Vacation schedule description: Things to do on vacation 2025-08-14 / 1 week: Have a good time

group Reunion Activities leader: Jane Smith 2025-09-09: Video call attendees: [sarah@example.com, igor@example.com] endGroup

Output

{ "events": { "propOrder": [], "tags": [], "title": "", "children": [ { "firstLine": { "full": "2025-04-09: Single date", "datePart": "2025-04-09", "rest": " Single date", "restTrimmed": "Single date" }, "properties": {}, "propOrder": [], "textRanges": { "whole": { "from": 0, "to": 24, "type": "event" }, "datePart": { "type": "dateRange", "from": 0, "to": 10 }, "definition": { "type": "dateRange", "from": 0, "to": 10 } }, "dateRangeIso": { "fromDateTimeIso": "2025-04-09T00:00:00.000+09:00", "toDateTimeIso": "2025-04-10T00:00:00.000+09:00" }, "tags": [], "supplemental": [], "matchedListItems": [], "isRelative": false }, { "firstLine": { "full": "2025-01-22 / 2026-10-24: Date range", "datePart": "2025-01-22 / 2026-10-24", "rest": " Date range", "restTrimmed": "Date range" }, "properties": {}, "propOrder": [], "textRanges": { "whole": { "from": 24, "to": 61, "type": "event" }, "datePart": { "type": "dateRange", "from": 24, "to": 47 }, "definition": { "type": "dateRange", "from": 24, "to": 47 } }, "dateRangeIso": { "fromDateTimeIso": "2025-01-22T00:00:00.000+09:00", "toDateTimeIso": "2026-10-25T00:00:00.000+09:00" }, "tags": [], "supplemental": [], "matchedListItems": [], "isRelative": false }, { "firstLine": { "full": "Dec 1 2025: Supports multiple date formats", "datePart": "Dec 1 2025", "rest": " Supports multiple date formats", "restTrimmed": "Supports multiple date formats" }, "properties": {}, "propOrder": [], "textRanges": { "whole": { "from": 61, "to": 128, "type": "event" }, "datePart": { "type": "dateRange", "from": 61, "to": 71 }, "definition": { "type": "dateRange", "from": 61, "to": 71 } }, "dateRangeIso": { "fromDateTimeIso": "2025-12-01T00:00:00.000+09:00", "toDateTimeIso": "2025-12-02T00:00:00.000+09:00" }, "tags": [], "supplemental": [ { "raw": "And longer descriptions", "type": "text" } ], "matchedListItems": [], "isRelative": false } ] }, "ids": {}, "ranges": [ { "type": "dateRange", "from": 0, "to": 10 }, { "type": "dateRangeColon", "from": 10, "to": 11 }, { "type": "dateRange", "from": 24, "to": 47 }, { "type": "dateRangeColon", "from": 47, "to": 48 }, { "type": "dateRange", "from": 61, "to": 71 }, { "type": "dateRangeColon", "from": 71, "to": 72 } ], "foldables": { "24": { "startIndex": 59, "endIndex": 60, "type": "event", "foldStartIndex": 59, "startLine": 1 }, "61": { "startIndex": 103, "endIndex": 127, "type": "event", "foldStartIndex": 103, "startLine": 3 } }, "header": {}, "parseMessages": [], "documentMessages": [ { "type": "warning", "message": "Timezone not specified. Specifying a `timezone` in the header is highly recommended." } ], "parser": { "version": "0.16.3" } }

View example timeline that uses all of markwhen's features.

Read more about markwhen's syntax, the parser, or views.

Apps & API

Timeline

Introduction

Diagram of repositories

Introduction ​

Diagram of repositories ​

Introduction

Diagram of repositories