You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -142,6 +142,7 @@ Or in Gmail:
142
142
-**Link opener** — links in emails are numbered `[1]`-`[0]` in the reader header; press `space+digit` to open in `$BROWSER`
143
143
-**CC, BCC, Reply-all** — optional Cc/Bcc fields (toggle with `ctrl+b`); `R` in the reader replies to sender + all CC recipients
144
144
-**Emoji reactions** — press `ctrl+e` from inbox or reader to react with emoji (👍 ❤️ 😂 🎉 🙏 💯 👀 ✅); instant send with proper threading and quoted message history, no editor needed; reactions appear in conversation threads with neomd branding
145
+
-**GitHub/Obsidian-style callouts in emails** — compose emails with callout syntax `> [!note]`, `> [!tip]`, `> [!warning]` for styled alert boxes in HTML emails; rendered with colored left borders, subtle backgrounds, and emoji icons
145
146
-**Drafts** — `d` in pre-send saves to Drafts (IMAP APPEND); `E` in the reader re-opens a draft as an editable compose; compose sessions are auto-backed up to `~/.cache/neomd/drafts/` so you never lose an unsent email (`:recover` to reopen)
146
147
-**HTML signatures** — configure separate text and HTML signatures; text signature appears in editor and plain text part, HTML signature in HTML part only; use `[html-signature]` placeholder to control inclusion per-email
147
148
-**Multiple From addresses** — define SMTP-only `[[senders]]` aliases (e.g. `s@ssp.sh` through an existing account); cycle with `ctrl+f` in compose and pre-send; sent copies always land in the Sent folder
Copy file name to clipboardExpand all lines: docs/content/docs/_index.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -149,6 +149,7 @@ Or in Gmail:
149
149
-**Link opener** — links in emails are numbered `[1]`-`[0]` in the reader header; press `space+digit` to open in `$BROWSER`
150
150
-**CC, BCC, Reply-all** — optional Cc/Bcc fields (toggle with `ctrl+b`); `R` in the reader replies to sender + all CC recipients
151
151
-**Emoji reactions** — press `ctrl+e` from inbox or reader to react with emoji (👍 ❤️ 😂 🎉 🙏 💯 👀 ✅); instant send with proper threading and quoted message history, no editor needed; reactions appear in conversation threads with neomd branding
152
+
-**GitHub/Obsidian-style callouts in emails** — compose emails with callout syntax `> [!note]`, `> [!tip]`, `> [!warning]` for styled alert boxes in HTML emails; rendered with colored left borders, subtle backgrounds, and emoji icons
152
153
-**Drafts** — `d` in pre-send saves to Drafts (IMAP APPEND); `E` in the reader re-opens a draft as an editable compose; compose sessions are auto-backed up to `~/.cache/neomd/drafts/` so you never lose an unsent email (`:recover` to reopen)
153
154
-**HTML signatures** — configure separate text and HTML signatures; text signature appears in editor and plain text part, HTML signature in HTML part only; use `[html-signature]` placeholder to control inclusion per-email
154
155
-**Multiple From addresses** — define SMTP-only `[[senders]]` aliases (e.g. `s@ssp.sh` through an existing account); cycle with `ctrl+f` in compose and pre-send; sent copies always land in the Sent folder
neomd supports GitHub/Obsidian-style [callouts](https://www.ssp.sh/brain/admonition-call-outs) through the [this extension (with my fork)](https://github.com/sspaeti/goldmark-obsidian-callout-for-neomd) for highlighted information boxes in your emails. Use the `> [!TYPE]` syntax to create styled alert boxes:
20
-
21
-
This is how it looks at the recievers end:
22
-

23
-
24
-
```markdown
25
-
> [!note]
26
-
> This is a note callout with default styling
27
-
28
-
> [!tip] Pro Tip
29
-
> Use custom titles by adding text after the type
30
-
31
-
> [!warning] Important
32
-
> Callouts can have multiple paragraphs
33
-
>
34
-
> Just add blank blockquote lines between them
35
-
36
-
> [!important]
37
-
> Recipients see colored boxes with icons in HTML email clients
38
-
> while plain text clients show it as a blockquote
39
-
```
40
-
41
-
**Available callout types:**
42
-
-`[!note]` — Blue info box
43
-
-`[!tip]` — Green success/tip box
44
-
-`[!important]` — Purple important box
45
-
-`[!warning]` — Yellow warning box
46
-
-`[!caution]` — Red caution/danger box
47
-
48
-
**Features:**
49
-
- Custom titles — add text after the type: `> [!warning] Security Alert`
50
-
- Multiple paragraphs — use `> ` (blockquote with space) for blank lines
51
-
- Works in both syntaxes: `> [!note]` (with space) or `>[!note]` (without space)
52
-
53
-
**What recipients see:**
54
-
55
-
HTML email clients (Gmail, Outlook, Apple Mail) display callouts as colored boxes with:
56
-
- Colored left border (4px solid)
57
-
- Colored background
58
-
- Bold title with icon
59
-
- Proper spacing and padding
60
-
61
-
>[!NOTE]
62
-
> Plain text email clients show callouts as regular blockquotes (graceful degradation).
63
-
64
-
**Example in composed email:**
65
-
66
-
```markdown
67
-
Hi team,
68
-
69
-
Here's the update on the project:
70
-
71
-
> [!tip] Good News
72
-
> We're ahead of schedule! The new feature shipped yesterday.
73
-
74
-
> [!warning] Action Required
75
-
> Please review the security audit by Friday.
76
-
>
77
-
> Contact @security if you have questions.
78
-
79
-
Thanks,
80
-
Simon
81
-
```
82
-
83
-
84
17
## Multiple From Addresses
85
18
86
19
Add `[[senders]]` blocks to config to define extra identities that share an existing account's SMTP credentials:
@@ -252,3 +185,66 @@ This gives you full control: professional HTML signatures by default, plain sign
252
185
For full HTML signature configuration examples, see [Configuration Reference](configuration#html-signatures).
253
186
254
187
For reading emails — images, links, attachments, and navigation — see [Reading Emails](reading).
188
+
189
+
## Callouts (Admonition)
190
+
191
+
neomd supports GitHub/Obsidian-style [callouts](https://www.ssp.sh/brain/admonition-call-outs) through the [this extension (with my fork)](https://github.com/sspaeti/goldmark-obsidian-callout-for-neomd) for highlighted information boxes in your emails. Use the `> [!TYPE]` syntax to create styled alert boxes:
192
+
193
+
This is how it looks at the recievers end:
194
+

195
+
196
+
```markdown
197
+
> [!note]
198
+
> This is a note callout with default styling
199
+
200
+
> [!tip] Pro Tip
201
+
> Use custom titles by adding text after the type
202
+
203
+
> [!warning] Important
204
+
> Callouts can have multiple paragraphs
205
+
>
206
+
> Just add blank blockquote lines between them
207
+
208
+
```
209
+
210
+
**Available callout types:**
211
+
-`[!note]` — Blue info box
212
+
-`[!tip]` — Green success/tip box
213
+
-`[!warning]` — Yellow warning box
214
+
215
+
**Features:**
216
+
- Custom titles — add text after the type: `> [!warning] Security Alert`
217
+
- Multiple paragraphs — use `> ` (blockquote with space) for blank lines
218
+
- Works in both syntaxes: `> [!note]` (with space) or `>[!note]` (without space)
219
+
220
+
**What recipients see:**
221
+
222
+
HTML email clients (Gmail, Outlook, Apple Mail) display callouts as colored boxes with:
223
+
- Colored left border (4px solid)
224
+
- Colored background
225
+
- Bold title with icon
226
+
- Proper spacing and padding
227
+
228
+
>[!NOTE]
229
+
> Plain text email clients show callouts as regular blockquotes (graceful degradation).
230
+
231
+
**Example in composed email:**
232
+
233
+
```markdown
234
+
Hi team,
235
+
236
+
Here's the update on the project:
237
+
238
+
> [!tip] Good News
239
+
> We're ahead of schedule! The new feature shipped yesterday.
0 commit comments