Skip to main content

Notes, Markdown, and Links

The notes field is the free-form part of every task: context, links, snippets, or a running log. It does more than hold plain text. It styles Markdown as you type, stamps in dates and times, links to other tasks, and gathers every link it finds into one menu. For the rest of the editor, see The Task Editor.

Opening Notes

Tap the notes row in the task editor, or press ⌘E with a hardware keyboard. The note opens as its own card titled Notes, with a toolbar docked along the bottom.

The card's top bar carries:

  • Done, which keeps the note and closes the card.
  • Hide Keyboard, shown while you are typing.
  • An options menu holding Share, Print, and Clear.

The Notes Toolbar

The toolbar splits into two groups. On the left are the commands that write into the note:

  • Bold
  • Italic
  • Strikethrough
  • Highlight
  • Bulleted List
  • Numbered List
  • Markdown Preview

On the right are the two that reach outside the text: Open Links and Insert Date & Time.

Each formatting command wraps the selection in its Markdown markers, or adds the list marker to every line you have touched. Tapping it again takes the markers back off.

Markdown in Notes

2Do styles Markdown live as you type. The source markers stay visible, so a **bold** word shows its asterisks and renders bold at the same time. Nothing is rewritten behind your back: what gets saved is always the Markdown you typed.

Supported Markdown

  • Emphasis: *italic* or _italic_
  • Strong: **bold** or __bold__
  • Code: `inline code` and fenced code blocks
  • Strikethrough: ~~struck~~
  • Highlight: ::highlighted::
  • Underline: <u>underlined</u>
  • Headings: # through ######
  • Blockquote: lines beginning with >
  • Lists: unordered and ordered; pressing Return at the end of a list line continues the marker
  • Links: [label](https://…) and bare web addresses
note

There is no GitHub-style task-checkbox rendering. A - [ ] line stays as literal Markdown text. Use 2Do's own sub-tasks or checklists for tickable items.

Markdown Preview

Tap the Markdown Preview button to swap the editable text for a rendered, read-only version. The card's title changes to Markdown Preview so you know why typing no longer does anything, and the button fills with the accent colour. Tap it again to go back to editing.

While preview is showing, the commands that write into the note are unavailable, along with the links menu. Preview never changes what is stored: the saved note is always the source Markdown.

Insert Date & Time

Tap Insert Date & Time to drop a formatted stamp at the cursor. It is useful for journaling progress or logging when something happened. The menu holds ten formats in three groups:

FormatWhat it inserts
Short Datelocalized short date
Short Date & Timelocalized short date with time
Long Datelocalized long date
Long Date & Timelocalized long date with time
Universal Dateyyyy-MM-dd
Universal Date & Timeyyyy-MM-dd plus the time in your clock format
ISO 8601 Date & TimeUTC yyyy-MM-dd'T'HH:mm:ss'Z'
Timecurrent time
Weekdayfull weekday name
Monthfull month name

The stamp replaces the selection and leaves the cursor after it.

Type @{ in a note and 2Do offers a list of tasks. Pick one and it drops in a live @{Task Title} link that jumps straight to that task. Because the link is just the task's title stored as ordinary text, you can also type one by hand, on any device.

For the full picture, including how links resolve and how they travel between devices, see Linking to Other Tasks.

As you type or paste, 2Do watches the note for links:

  • Task links: @{…} tokens.
  • Web and mail addresses.

Detected links are underlined in the note, so you can tap one where it sits. When a long note buries them between paragraphs, tap Open Links in the toolbar instead: the menu lists every link it found under a heading that counts them, such as Found 4 Links, with task links first and web addresses after them. A note with no links shows a message to that effect rather than leaving the button dead.

Sharing, Printing, and Clearing

The options menu in the notes card's top bar holds three commands:

  • Share hands the note's text to the system share sheet.
  • Print hands it to the system print screen, with the task's title as the job name.
  • Clear empties the note. It asks first.

Share and Print are unavailable while the note is empty, and Clear is unavailable on a list you cannot change.

Tips

tip

Because the saved note is always the source Markdown, notes round-trip through sync and through 2Do on other platforms without losing their formatting markers.

tip

Use @{ links to stitch related tasks together. A project's notes can point at each of its dependencies, and one tap jumps you straight there.