A minimal email TUI where you read with Markdown and write in Neovim.
neomd.ssp.sh/docs
email
markdown
neovim
tui
update docs
+19
-3
+3
-1
README.md
+3
-1
README.md
···
16
16
17
17
With the [GTD approach](https://www.ssp.sh/brain/getting-things-done-gtd), using folders such as next (inbox), waiting, someday, scheduled, or archive, you can move them with one shortcut. This allows you quickly to move emails you need to wait for, or deal with later, in the right category. **Processing your email only once**.
18
18
19
-
With the additional **Feed** and **Papertrail**, two additional features from HEY, you can read newsletters (just hit F) on them automatically in their separate tab, or move all your receipts into the Papertrail. Once you mark them as feed or papertrail, they will moved there automatically going forward. So you decide whether to read emails or news by jumping to different tabs.
19
+
Also, we intentionally don't add more folders to the archive or file emails too, only archive (and work if you use business/personal - but that's not even needed). The goal is to let emails fade out, avoid the "busy work," and file them. We use search when we need it, or copy important information into Obsidian or our daily work. That's why we only have limited folders (and also why we currently can't add additional ones; see [FAQ](https://ssp-data.github.io/neomd/docs/faq/#is-it-possible-to-create-new-directoriestabs).
20
+
21
+
But we have two additional **Feed** and **Papertrail**, two dedicated folders from HEY where you can read newsletters (just hit F) on them automatically in their separate tab, or move all your receipts into the Papertrail. Once you mark them as feed or papertrail, they will moved there automatically going forward. So you decide whether to read emails or news by jumping to different tabs.
20
22
21
23
22
24
> [!NOTE]
+3
-1
docs/content/docs/_index.md
+3
-1
docs/content/docs/_index.md
···
21
21
22
22
With the [GTD approach](https://www.ssp.sh/brain/getting-things-done-gtd), using folders such as next (inbox), waiting, someday, scheduled, or archive, you can move them with one shortcut. This allows you quickly to move emails you need to wait for, or deal with later, in the right category. **Processing your email only once**.
23
23
24
-
With the additional **Feed** and **Papertrail**, two additional features from HEY, you can read newsletters (just hit F) on them automatically in their separate tab, or move all your receipts into the Papertrail. Once you mark them as feed or papertrail, they will moved there automatically going forward. So you decide whether to read emails or news by jumping to different tabs.
24
+
Also, we intentionally don't add more folders to the archive or file emails too, only archive (and work if you use business/personal - but that's not even needed). The goal is to let emails fade out, avoid the "busy work," and file them. We use search when we need it, or copy important information into Obsidian or our daily work. That's why we only have limited folders (and also why we currently can't add additional ones; see [FAQ](https://ssp-data.github.io/neomd/docs/faq/#is-it-possible-to-create-new-directoriestabs).
25
+
26
+
But we have two additional **Feed** and **Papertrail**, two dedicated folders from HEY where you can read newsletters (just hit F) on them automatically in their separate tab, or move all your receipts into the Papertrail. Once you mark them as feed or papertrail, they will moved there automatically going forward. So you decide whether to read emails or news by jumping to different tabs.
25
27
26
28
27
29
{{< callout type="info" >}}
+1
-1
docs/content/docs/configurations/proton-bridge.md
+1
-1
docs/content/docs/configurations/proton-bridge.md
···
42
42
someday = "Folders/Someday"
43
43
spam = "Spam"
44
44
work = ""
45
-
tab_order = ["inbox", "to_screen", "feed", "papertrail", "waiting", "sched", "someday", "archive", "sent", "drafts", "screened_out", "spam", "trash"]
45
+
tab_order = ["inbox", "to_screen", "feed", "papertrail", "waiting", "scheduled", "someday", "archive", "sent", "drafts", "screened_out", "spam", "trash"]
46
46
47
47
```
48
48
+12
docs/content/docs/faq.md
+12
docs/content/docs/faq.md
···
6
6
Questions that came up when people using neomd.
7
7
8
8
9
+
9
10
## Is it possible to create new directories/tabs
10
11
11
12
Currently, no. All folders are hard coded in a struct in a code as this is optimized for the GTD and HEY Screener workflow and keeps things simple.
···
61
62
```
62
63
63
64
The html-signature is the placeholder for adding the HTML signature, but yes, it will always be added at the end of the email (e.g. in this case the reply).
65
+
66
+
## The Drafts and Spam folders seem to show wrong emails
67
+
68
+
Drafts and Spam are **off-tab folders** (not in the regular tab rotation) and behave slightly differently:
69
+
70
+
- **Access**: `gd` for Drafts, `gS` for Spam (or `:go-spam`)
71
+
- **Indication**: When viewing them, the folder name appears highlighted in the tab bar with a `│` separator
72
+
- **Reload**: Pressing `R` reloads the Drafts/Spam folder
73
+
- **Leave**: Press `tab` or navigate to another folder (`gi`, `ga`, etc.) to return to regular tabs
74
+
75
+
**Old bug (fixed 2026-04-10)**: In older versions, pressing `R` while viewing Drafts could show Inbox content. If you experience this, rebuild neomd to get the fix.