# mark-when/markwhen

Make a cascading timeline from markdown-like text. Supports simple American/European date styles, ISO8601, images, links, locations, and more.

Repository: https://github.com/mark-when/markwhen
Canonical: https://ross.abutalabs.com/products/markwhen
Homepage: https://markwhen.com
Language: HTML
License: MIT
License Family: permissive
Topics: markdown, timeline, calendar, maps, markwhen, events, visualization, gantt, editor, gantt-chart, gantt-diagram, project, project-management, vscode, vscode-extension
Last push: 2023-12-11T19:14:41+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 1931, "days_push": 996, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4869, forks 159 (observed 2026-08-28T04:09:01.599281+00:00)

## What it is
Markwhen is a markdown-like journal language and toolchain that converts plain text with dates into JSON, which is rendered as cascading timelines, calendars, and other views. This repository hosts the view container; the parser, timeline, calendar views, and VS Code extension live in sibling repositories under the mark-when organization.

## Use cases
- create a gantt chart from plain markdown text
- visualize a project timeline by writing dates in a text file
- turn a markdown journal into a cascading timeline
- render a calendar view from markdown-like event text
- plan a project schedule without heavyweight PM software
- embed an interactive timeline in a web page or VS Code

## When to choose
- you want to author timelines or gantt charts as plain text
- you prefer lightweight text-based project planning over GUI tools
- you need multiple output views (timeline, calendar, resume) from one document
- you want a VS Code workflow for timeline documents

## When to avoid
- you need a full-featured GUI project management suite with dependencies and resource allocation
- you need the hosted editor itself, which is not open source
- you require real-time multi-user scheduling or calendar sync with external services

## Facets
- artifact type: application
- maturity: active
- function: data-visualization, parser, templating, developer-tools
- domain: data-visualization, developer-tools, web-development, text-editors
- platform: browser, cross-platform, editor-plugin
- tags: timeline, gantt-chart, markdown, calendar, text-to-timeline, vscode-extension, journaling, project-management, automation, web-server

## Member repositories
- mark-when/markwhen (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:01.599281+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:18:20.198665+00:00, confidence not recorded.
  - readme: https://github.com/mark-when/markwhen (fetched 2026-08-28T04:09:01.599281+00:00, sha 9da9ac7b7c84)
  - homepage: https://markwhen.com (fetched 2026-08-29T09:00:52.774665+00:00, sha 6bf3fe125bb4)
  - site_page: https://docs.markwhen.com/remarking (fetched 2026-08-29T09:00:52.787511+00:00, sha a22ec0adad8c)
  - site_page: https://docs.markwhen.com (fetched 2026-08-29T09:00:52.784055+00:00, sha 16c3808ddea6)
  - site_page: https://docs.markwhen.com/meridiem (fetched 2026-08-29T09:00:52.785965+00:00, sha 86f088754ffc)
  - site_page: https://docs.markwhen.com/ (fetched 2026-08-29T09:00:52.789300+00:00, sha 16c3808ddea6)
- Data as of 2026-08-30T08:39:29.467469+00:00.