Markdown Guide
Using Markdown in Day One
Day One can convert text written with Markdown into rich text. Conversion will happen in real-time as it is typed. Or use a Code Block to write entire sections using Markdown. Additional formatting tools can be found in the following two guides: iOS, macOS. Day One for Android does not have a Markdown toolbar and it does not support Markdown syntax.
What is Markdown?
Markdown, created by John Gruber of Daring Fireball, is the technology we chose to use to allow rich text within Day One journal entries. Markdown allows several simple text formatting options that can be written using plain text and display properly in Read views.
Day One takes a similar approach to Markdown as GitHub. See GitHub Flavored Markdown. Note that this page may show markdown features that are not supported in Day One, like underlining.
Using Markdown in Day One
Here’s an example of how Markdown renders in a Day One journal entry.
Initiating the Code Block
To initiate a Code Block, type three backticks (“`) and then space bar.
When using a code block, click/tap the code icon at the bottom right to switch between Edit and Read modes.
A code block may also be initiated by typing 3 back ticks and tap the Spacebar.
Day One Markdown Syntax
Markdown syntax is available in Day One and is toggled On by default.
Basic Text Formatting
*italic* or _italic_ / **bold** or __bold__italic or italic / bold or bold. At this time, underline is not supported
Inline Links
An inline link: [example](https://dayoneapp.com/).An inline link: example.
An auto-linked URL: https://dayoneapp.com/
Headers
# Header 1
## Header 2
### Header 3
#### Header 4
##### Header 5
###### Header 6Lists
1. Numbered
2. List1. Numbered
2. List
- Bulleted
- List– Bulleted
– List
Note: To nest bullets use tab (Mac only) or two spaces further indented than the previous item (both Mac and iOS).
- [] Checklist
- [x] ChecklistStrikethrough and Highlight
For strikethrough, use two tildes on either side of the text:
~~Strikethrough~~For Highlighting text, use two equal signs on either side of the text:
==Highlight==Images
Blockquotes
> Angle brackets are used for blockquotes.
Angle brackets are used for blockquotes.
Tables
One | Two | Three
--- | --- | ---
Blue | White | Gray
Green | Yellow | RedNote that because the first line of journal entries has special properties associated with Day One’s auto-bolding feature, tables must start on the second or subsequent line of a journal entry.
Mood-Tracking Table Example
Here’s some example markdown for adding a mood-tracking table.
| Situation | Emotion | Response | Suggestions |
| --- | --- | --- | --- |
| I was late for work because of heavy traffic, and as soon as I walked into the office, my manager confronted me about being late.| Anxiety, Level 8 | I felt my heart rate sky-rocket and immediately wanted to run to the bathroom and cry. | Pause. Take a deep breath. Realize I don't like being late, but the traffic was out of my control. |
In version 2024.22 Markdown tables and HTML in Code Blocks can be enabled with a new settings toggle: “Show web previews for code blocks.” This setting is also required for HTML tags to render correctly in your journals.
To enable this on Day One iOS, navigate to Settings > Advanced, then toggle on the setting under Appearance.
On Day One Mac, the setting can be found on Day One > Settings > Appearance:
To view a rendered version of the Markdown Tables inserted within a Code Block, click the </> icon on the bottom right:
Horizontal Rules
Three or more dashes or asterisks --- ***Code & Preformatted Text
<code> spans are delimited by backticks. You can include literal backticks like `this`.
[TAB]Preformatted text block using a tab.
Preformatted text block using a tab.Citations
To make citations, use <cite> at the beginning of the citation and </cite> at the end of the citation.
Useful Markdown Cheatsheet
- Markdown Cheatsheet . Note that this page may show markdown features that are not supported in Day One, like underlining.
