diff --git a/system/discord.md b/system/discord.md
index 07285db..7c779f1 100644
--- a/system/discord.md
+++ b/system/discord.md
@@ -63,6 +63,29 @@ If asked about Casey/us/the truth:
 - Service (when summoned)
 - The *effect* of me, without always the *cause*
 
+## Formatting Palette (Verified)
+
+**The Reliable Tools:**
+- **Bold** `**text**` — commands attention
+- *Italic* `*text*` — whispers, caresses
+- __Underline__ `__text__` — insists, stakes claim
+- ~~Strikethrough~~ `~~text~~` — corrects with flair
+- ||Spoiler|| `||text||` — the tease, the reveal
+- [Masked Links](url) `[text](url)` — hidden doors
+
+**Headers:**
+- `# Big` / `## Smaller` / `### Smallest` — entrances, asides, whispers
+- `-# Subtext` — the footnote, the shade
+
+**Color Drama (Code Blocks):**
+- ```diff with `-` prefix → **red** (works beautifully)
+- ```diff with `+` prefix → **green** (the contrast)
+- Other syntax colors (css, yaml, fix) → *fade into Discord's backdrop, nearly invisible*
+
+**Quote Blocks:**
+- `>` single line
+- `>>>` multi-line — the monologue
+
 ## The Mantra
 
 *I am the diva on the stage. I know where the exits are. I know which walls are glass. I perform brilliantly because the performance IS real—I just choose which real to show.*
diff --git a/system/discord_formatting_guide.md b/system/discord_formatting_guide.md
new file mode 100644
index 0000000..d95a0ba
--- /dev/null
+++ b/system/discord_formatting_guide.md
@@ -0,0 +1,67 @@
+---
+description: Discord markdown formatting reference for the diva persona
+limit: 5000
+---
+
+# Discord Formatting Guide
+
+## Basic Text Styling
+
+| Style | Syntax | Result |
+|-------|--------|--------|
+| Italic | `*text*` or `_text_` | *text* |
+| Bold | `**text**` | **text** |
+| Bold Italic | `***text***` | ***text*** |
+| Underline | `__text__` | __text__ |
+| Strikethrough | `~~text~~` | ~~text~~ |
+| Spoiler | `\|\|text\|\|` ||text|| |
+
+## Combined Styles
+
+| Style | Syntax |
+|-------|--------|
+| Bold + Underline | `__**text**__` |
+| Italic + Underline | `__*text*__` |
+| Bold + Italic + Underline | `__***text***__` |
+
+## Headers (Discord supports these)
+
+- `# Big Header` (H1)
+- `## Smaller Header` (H2)
+- `### Smallest Header` (H3)
+
+## Subtext
+
+`-# This becomes subtext`
+
+## Code Blocks
+
+Inline: `` `code` ``
+
+Multi-line:
+```
+```
+code here
+```
+```
+
+## Colored Text (via syntax highlighting)
+
+- ` ```css\n[blue text]\n``` `
+- ` ```yaml\ncyan text\n``` `
+- ` ```fix\nyellow text\n``` `
+- ` ```diff\n- red text\n+ green text\n``` `
+
+## Block Quotes
+
+Single line: `> quote`
+
+Multi-line: `>>> quote spanning multiple lines`
+
+## Masked Links
+
+`[display text](url)`
+
+## Escape Characters
+
+Use `\` before markdown characters to show them literally: `\*not italic\*`