Tags #

Events in markwhen can be tagged with the # syntax:

2020: Mostly uneventful year #covid

Here, the event has the tag #covid. In views that support different colors, this event will have a distinct color from other, untagged events.

Colors #

You can specify a tag's color in the header:

---
#covid: blue
---

2020: Mostly uneventful year #covid

Timezones #

Tags can indicate additional information aside from color. Say you took a trip to a different country and want to tag all events that took place there:

---
#covid: blue
#london: green
---

2020: Mostly uneventful year #covid

group year abroad #london
2023-06-01: the king was coronated or something
...
endGroup

Assuming the country you're traveling to is in a different time zone, events in the group year abroad will have the "wrong" time zone. We can add timezone to the tag's definition in the header:

---
#covid: blue
#london:
  color: green
  timezone: Europe/London
---

2020: Mostly uneventful year #covid

group year abroad #london
2023-06-01: the king was coronated or something
...
endGroup

Here we have explicitly set the color of the #london tag to be green and the timezone to be Europe/London. Now events in our year abroad group will have the right zone.

We can (and should) even be more specific by specifying a default zone:

---
timezone: America/New_York

#covid: blue
#london:
  color: green
  timezone: Europe/London
---

2020: Mostly uneventful year #covid

group year abroad #london
2023-06-01: the king was coronated or something
...
endGroup

This way, any event that isn't otherwise explicitly given a zone will be in the America/New_York zone.

Time zones can be specified by their name, like America/Los_Angeles, or by a offset, like +5 or -3.

Reminders (beta) #

Markwhen.com can send you email reminders about events. If you want to get reminders for all events, specify a top-level entry in your header:

---
title: Important meetings
reminders: [1 day]
---

2023-09-08: ...

Alternatively you can specify reminders on specific tags, to only receive reminders about events that have that tag:

#work:
  reminder: 15 minutes

In this case, you will get an email about events tagged with #work 15 minutes before they begin.

Instead of a singular duration, you may specify a list of durations, and you will get an email for each one accordingly:

#work:
  reminders:
    - 15 minutes
    - 1 hour

#personal:
  reminders: [1 day, 7 days]

You may use either reminder or reminders for your syntax (just don't use both on one tag).

You may get even more specific with your reminders with beforeBegin, afterBegin, beforeEnd, and afterEnd that send reminder(s) before or after an event begins or ends:

#work:
  color: red
  timezone: America/New_York
  reminders:
    beforeBegin:
      durations: [30 minutes, 15 minutes]
    afterBegin:
      durations:
        - 30 minutes
    beforeEnd: 15 minutes
    afterEnd:
      ...

Sep 8 2023 9am: Suport important meeting #work

Note that currently reminders do not work with recurring events - only the first instance of the event will trigger any applicable reminders.

Multiple tags #

Events, groups, and sections all support multiple tags, but their behavior with given properties becomes undefined -- or at least less defined.

Basically, do not expect smart merging of tags' properties:

#school: red
#work: yellow

2021: Was working while in school #school #work

Events tagged with both #school and #work will not be colored orange because #school is red and #work is yellow. It will be one or the other. Similarly with timezones -- an event can't simultaneously have two different timezones. You should be specific with your tags. Reminders, however, are cumulative. If you have different reminders set on two different tags, an event with both tags will receive both sets of reminders.