diff --git a/README.md b/README.md
index 5c18c51..5c1d90b 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,88 @@
-112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312112312
\ No newline at end of file
+# Markdown Showcase - The Developer's Guide
+*Created for W2Wizard on 2025-04-16*
+
+## 📋 Table of Contents
+- [Headers](#headers)
+- [Text Styling](#text-styling)
+- [Lists](#lists)
+- [Code](#code)
+
+## Headers
+# Main Heading (H1)
+## Second Level (H2)
+### Third Level (H3)
+#### Fourth Level (H4)
+##### Fifth Level (H5)
+###### Sixth Level (H6)
+
+## Lists
+### Ordered List
+1. First item
+2. Second item
+   1. Nested item
+   2. Another nested item
+3. Third item
+
+### Unordered List
+- Item one
+- Item two
+  * Nested with asterisk
+  + Nested with plus
+- Item three
+
+### Task List
+- [x] Completed task
+- [ ] Pending task
+- [ ] @W2Wizard assigned task
+
+## Code
+```ts
+// C# code block with syntax highlighting
+services.AddAuthorizationBuilder()
+    .AddPolicy("IsCreator", policy => 
+        policy.RequireClaim(ClaimTypes.Role, "creator"));
+```
+
+## Links & Images
+[GitHub](https://github.com)
+![Alt text for image](https://via.placeholder.com/150)
+
+## Tables
+| Feature | Supported | Notes |
+|---------|:---------:|-------|
+| Tables  | ✅ | Left, center, right alignment with `:` |
+| Images  | ✅ | No native resizing |
+| Emojis  | ✅ | 🚀 🔥 💻 |
+
+## Quotes & Notes
+> This is a blockquote
+> 
+> It can span multiple lines
+
+> Nested quotes
+>> Work like this
+
+## Advanced Features
+
+<details>
+<summary>Click to expand details section</summary>
+
+Hidden content appears here! Great for FAQs or long explanations.
+</details>
+
+---
+
+### Definition Lists
+Term
+: Definition goes here
+
+### Math Equations (with MathJax/KaTeX support)
+When $a \ne 0$, there are two solutions to $ax^2 + bx + c = 0$ given by:
+$$x = {-b \pm \sqrt{b^2-4ac} \over 2a}$$
+
+### Diagrams (with Mermaid support)
+```mermaid
+graph TD;
+    A[Start] -->|Process| B[End];
+    A -->|Alternative| C[Result];
+```
\ No newline at end of file