Show HN: Markwhen: Markdown for Timelines

[koch]

Creator here - glad to see people like markwhen!

Been working on markwhen for a few years now, originally inspired by cheeaun's life timeline that another commenter posted about.

At this point markwhen is available as a VS Code extension, Obsidian plugin, CLI tool, and web editor in Meridiem.

Some recent markwhen developments:

- Dial, a fork of bolt.new (Stackblitz's very cool tool that leverages AI to help quickly scaffold web projects): an in-browser editor that lets you edit existing markwhen visualizations like the timeline or calendar or make your own. I just released that yesterday so it's still rough but I have big plans for it (it's one of the visualizations in meridiem)

- Event properties: each entry can have it's own "frontmatter" in the form of `key: value` pairs. I wanted this as I'm aiming for more iCal interoperability in the future, so each event could theoretically have things like "attendees" or google calendar ids or other metadata. This was released in the last month or two.

- remark.ing: this one isn't ready yet by any means but it's like a twitter/bluesky/mastodon-esque aggregated blog site. So you write markwhen and each entry is a post. In this way "scheduling" a post is just writing a future date next to it, and you have all your blog in one file. This one is a major WIP

[mturk]

I used Markwhen recently to make an interactive Gantt chart for a proposal to a collaborator and it went swimmingly. (We got the gig!) So, thank you!

For the record, I used the Obsidian plugin to develop, then deployed as static HTML.

[makach]

Congratulations on your release! I've working on building exactly the same tool but you beat me to it... I cannot compete with this functionality, and completeness. Amazing work!

[d--b]

Looks very good.

Just a note. It was really hard to find how to sign up.

EDIT: and I still haven't found how to sign in in the desktop app.

[RestartKernel]

Remark.ing sounds incredible. I've been considering building something like Memos but based on Markdown files rather than a relational database for personal use, but this comes really close to what I was looking for.

Are you planning to open source it? I couldn't find it on your GitHub.

[Brajeshwar]

What is the difference between the free and the monthly subscription tier?

[cheeaun]

Great to see this again. Amazing how this tool expanded so much over the years!

[EarlOfCamden]

nice! I've been thinking I will need something like this in Obsidian at some point, good to know it already exists.

[jagermo]

pretty nifty tool. What license are you using for distribution?

[accrual]

This is neat! It reminded me of this project by cheeaun that enables one to create a visual timeline based on a simple texted based format. The purpose was to plot one's life events in a visual way.

https://github.com/cheeaun/life

Sample file (from the repository):

    @USERNAME's life
    ===============

    - 24/02/1955 Born
    - ~1968 Summer job
    - 03/1976 Built a computer
    - 01/04/1976 Started a company
    - 04/1976-2011 Whole bunch of interesting events

[AlanYx]

That is a great project! I wonder if anyone has created a visualization that uses a "life in weeks" format (like https://waitbutwhy.com/2014/05/life-weeks.html) rather than a linear horizontal timeline.

[atoav]

Note that Mermaid also supports timelines (if it is new enough): https://mermaid.js.org/syntax/timeline.html

Mermaid is supported by gitlab/github and other markdown editors (within code blocks).

[otikik]

The charts you linked don't look like the same kind of chart to me. There's information about what happened after what, but the information about how much each task took seems missing.

[bcooney_info]

i was using mermaid for this for years, but markwhen just seems/feels instantly easier.

[bergie]

This is pretty cool! I'm the developer of a semi-automatic electronic logbook system for sailboats: https://bergie.iki.fi/blog/electronic-logbook/

Right now I'm using YAML for the file format, as I wanted something that would be reasonably readable for both humans and machines. Markwhen would also fit the bill nicely, so that's something to consider, at least as an export format. My entries have a lot of properties, though (stuff like wind speed, vessel coordinates, barometer, etc). Traditional ship's logbooks were done in a tabular manner to record all this. So I'm not sure if that would end up looking quite messy. Here is an example of a day of log entries in the current format: https://github.com/meri-imperiumi/log/blob/main/_data/logboo...

I'm using these also for some data analysis, like watermaker membrane health, or sailed miles per crew member.

[tiffanyh]

Be careful.

Gruber (who has trademark in “Markdown”), appears to not like people using his trademark name.

https://blog.codinghorror.com/standard-markdown-is-now-commo...

[SllX]

Not only is this a different name, but that was an attempt to essentially expropriate Markdown. This is nothing even close to that.

[dewey]

Here's the license (http://daringfireball.net/projects/downloads/Markdown_1.0.1....) and I don't think Gruber mentioned anything about a "trademark"? It seems like it was mostly about the name of his project just being taken unethically. Just like if someone would take a open source project name and makes it look like an official for when it's not. Maybe not a trademark infringement, but certainly not nice or ethical.

[BonoboIO]

I searched for a trademark for „Markdown“, but I didn’t find any. Can you show me the trademark?

[philipwhiuk]

Joel tried to write an IETF Standard by the backdoor for a thing he didn't invent.

Having been kicked off the word standard, they immediately thought "how can we still do this while technically obeying it". So they picked the closest possible word to Standard, implying it really was the definitive version.

Yeah, I'd be grumpy too.

If he'd called it 'Atwood Flavoured Markdown' there wouldn't be an issue. But Joel wanted to own the definition of Markdown.

As a group of tech CEOs they decided to co-opt someone's idea without even asking if it was okay.

In fact kicking John off the project was the point.

You can do that, you just can't keep the name they created.

[BonoboIO]

Wow … John Gruber was also very upset, … , that the word Markdown was not capitalized throughout the spec.

[cal85]

This has a different name.

[dotancohen]

Again reimplementing Emacs Org mode. Nice work!

This looks terrific, but honestly Markdown is a document markup language. Org mode, while superficially similar in scope, is actually a data storage and exchange format. The data manipulation and querying built around Org mode are unlikely to be replicated in Markdown.

[vslavkin]

Agree. This could be easily done in org. I feel that if org was more popular, a lot of these solutions would disappear, or would be a small project that just reads some org properties. I guess it would be key to have better support for easier editors, like vscode and maybe even a dedicated editor

[uludag]

Just to name a few, https://github.com/legalnonsense/elgantt/, https://github.com/elsatch/org-timeline-viewer, https://orgmode.org/worg/org-tutorials/org-taskjuggler.html . Org-mode users and things like this seem to be like moths and a fire. I'm always surprised by the sheer amount of packages written for org-mode, a package itself of a rather niche piece of software.

[ambigious7777]

I really want to like Org mode, but I just can't. The syntax feels too out of place. With markdown it's just a few extra symbols, but using Org mode feels like writing LaTeX in a way.

Same thing with MediaWiki - I love the wiki system but WikiText is just so bad.

[KaoruAoiShiho]

Does this work at all for fantasy timelines?

Trying to build a timeline like this:

title: History of the World

0: Foo Calendar's civilization founding.

124: Invention of the Foo Calendar

220: Founding of Bar

1310: Invention of GlooblyGock

5621: Demon invasion.

Edit: After trying it don't think it works for this usecase.

[wild_egg]

Seems not right for the comments here to be empty but I don't have much to say other than this looks incredibly nice. Hope I have an excuse to use it at some point.

Thanks for sharing!

[yawnxyz]

two years ago, this post got almost 400 points! https://news.ycombinator.com/item?id=31810876

[capnahab]

seconded.

[neumann]

Just in case anyone else is out of the loop like me. This can be used as a plugin in obsidian! https://obsidian.md/plugins?search=markw

[KaoruAoiShiho]

Any chance you can copy some of this for aesthetics? https://www.chronoflotimeline.com/timeline/shared/3118/Home-...

[alexkearns]

Ha! That's my product. Thanks for mentioning!

[owlglass]

Hopefully without the latency, it's slow to respond on a 2022 M2 Macbook Air (tried Firefox and Safari)

[sprobertson]

Besides the tool itself that website typography is excellent. Guess I'll have to use Playfair in my next project.

Edit: One thing I'd like to see with the basic syntax example is fiddle with your default dates to make it more obvious that the span is a span. At the time scale it is now, it just looks like another dot.

[koch]

Just edited the example so it looks like a span, thanks for the feedback!

[snappr021]

This looks very good.

Is there syntax for dependent tasks in the timeline? In other words tasks that only start once prerequisites are done.

If the date of the original tasks changes, the dependent tasks move accordingly automatically, without needing to edit a full list of dates for each dependent item.

[genezeta]

It's a timeline that tracks events and periods. It doesn't seem to have the concept of a task in any way.

[einpoklum]

> for plainly writing logs , gantt charts , blogs , feeds , notes , journals etc.

So, how would this combine with markdown, for the content within dated blog/journal entries? And how would I use dates as plain dates rather than special markwhen entities?

[SuperV1234]

This is really cool, I wish there was some sort of life planner software where I can write down appointments, notes, ideas, and more in a simple format like Markdown, and automatically get notifications/reminders based on what I wrote.

[funnybeam]

Have you looked at org mode for eMacs? That does precisely this

[nemacol]

Big fan of timelines. I am going to use this for sure

Have had an idea for a timeline search/visualization. Search a thing and that pulls pages and related pages with date/times from Wikipedia. With a zoom in/out to adjust resolution like google maps - weight nodes on timeline based on page views/edits/links. Have not gotten around to try to make something like it. I bring it up here just in case something already exists and I missed it.

[dustedcodes]

Things like Markdown work because they are intuitive, but the date range syntax in Markwhen is anything but intuitive.

Why 2025-01-22 / 2026-10-24?

Why not 2025/01/22 - 2026/10/24?

[dimava]

Because this is ISO 8601 date format, the standard date format that intentionally uses dashes to not confuse 25/01/22, 01/22/25 and 22/01/26 which are the same date in different formats

(that's why it uses dashes for dates, as for why it uses / for interval I have no idea)

[ramses0]

Better: 2025-01-01..2025-01-31: (eg: git-log-ish format)

[account42]

I'm with you on / not being a good range separator but using it for the individual dates is much much worse. Please stick to - for YYYY-MM-DD to avoid confusion and keep / restricted to inbred date formats.

[jiangplus]

This reminds me of blocks.md (https://blocks.md/), a Markdown based form builder.

[pflenker]

Great project, I always felt that this was missing in Markdown.

I wonder how we can "end" a timeline and start a new one in the same doc? So that I can write stuff like:

# My important project.

Description of the project goes here

## Timeline of the project.

2024-12-02: This is what I did today.

2024-12-01: This is what I did yesterday.

# My other important project.

Description of the project goes here.

## Timeline of the project.

2024-12-03: This is what I plan tomorrow.

---

Some thoughts about what I have written above.

[garfieldnate]

I would love to be able to manage my actual calendar with this. By which I mean, I want a seamless bridge with google calendar, iCal, etc. that also lets me view, edit, source-control, etc. my calendar with an mw file. I think this is very cool!

[marjipan200]

Love this! If you're into representing time with simple markdown, check out the Chronos Timeline plugin for Obsidian too

https://obsidian.md/plugins?search=chronos+timeline

[rhizoma]

Nice that it installs on mobile too.

[robinhowlett]

This looks excellent - i've been looking for a timeline-based, simple-entry tool like this. Well done.

[SamBam]

How would one go about creating Obsidian support for a timeline that was scattered across multiple files?

I'm thinking like the network visualizer that Obsidian has, it would be great if it could find tagged dates in any file and display them on a common timeline.

[nivertech]

What shortcut used to preview Markwhen documents in Obsidian?

I create a "Markwhen" folder and create a "test.mw" not there, but it doesn't render, and I can't an option for preview in the command palette.

[thomasreggi]

Just wanted to say congrats on the project. This is truly a masterpiece from the utility of it, the novelty, to execution with the vscode / meridian app, and sass. Brilliant execution!

[dirkc]

I'd love something that can support uncertain timelines - I maintain a list of space events that I'm interested in, but I haven't yet figured out how to do the dates.

[jusgu]

Nice, these “Markdown for X” tools are super neat. Wish this worked nicely with mobile view, seems like a lot of the text are overflowing and margins are squished in the demo

[shepherdjerred]

I wonder how easy it is to render the timeline in a custom manner

[x1ph0z]

Really cool project, looking forward to using it in Obsidian.

[desireco42]

OK, this is fantastic, like others mentioned. Now... to figure out how to use it in existing markdown... love the Obsidian integration.

[IndieCoder]

That is such an elegant solution. True sweet spot which was missing for me in traditional markdown!

[rattray]

Belated, but especially when I see the group syntax, I wonder if this should be like a Markdoc extension or something?

[noisy_boy]

This is neat. What I am waiting for is markdown for tables with cells supporting multiline content in an easy to use manner.

[ynx]

Meridiem seems to only have ARM builds, no Intel builds. Could you perhaps update it to include Intel?

[neoconomist]

Neat, something like this was missing in my text-based workflow. Thanks for building !

[sleepyfran]

This looks amazing, will definitely try to incorporate it into my workflow!

[_ink_]

Awesome! I really would like to see a Discourse Plugin for that.

[omnster]

Looks neat! Is there a way to make it work with pandoc?

[Siira]

Is there something similar for org-mode?

[markgoho]

are those the actual pronunciations of your products?

here'd be my recommendation: /ˈmɑːɻk.wɛn/ and /məˈɻɪd.i.ən/

[teo_zero]

Does it work with non-English dates?

[jbaber]

Is there support for date ranges? e.g. 2024-12-25 - 2025-01-06 ?

[ks2048]

It's the second example in "Basic Syntax" on the right.