Merge pull request #71 from eqtylab/markdown-improvements

Author: Shrinks99

docs/docs/assets/cupcake-dark.svg

@@ -4,8 +4,6 @@ heading: "Installation"
 description: "Install Cupcake on your system"
 ---
 
-## Quick Install
-
 Install Cupcake using the official install scripts:
 
 ### Unix/macOS
@@ -33,48 +31,52 @@ If you prefer to install manually or need a specific version, you can download p
 
 ### Install OPA
 
-#### macOS
+???+ info "Install OPA"
 
-```bash
-brew install opa
-```
+    === "macOS"
 
-Or download directly:
+        Using Homebrew
 
-```bash
-# Apple Silicon (M1/M2/M3)
-curl -L -o opa https://openpolicyagent.org/downloads/latest/opa_darwin_arm64
+        ```bash
+        brew install opa
+        ```
 
-# Intel Macs
-curl -L -o opa https://openpolicyagent.org/downloads/latest/opa_darwin_amd64
+        Or download directly:
 
-chmod 755 opa
-sudo mv opa /usr/local/bin/
-```
+        ```bash
+        # Apple Silicon (M1/M2/M3)
+        curl -L -o opa https://openpolicyagent.org/downloads/latest/opa_darwin_arm64
 
-#### Linux
+        # Intel Macs
+        curl -L -o opa https://openpolicyagent.org/downloads/latest/opa_darwin_amd64
 
-```bash
-# AMD64
-curl -L -o opa https://openpolicyagent.org/downloads/latest/opa_linux_amd64
+        chmod 755 opa
+        sudo mv opa /usr/local/bin/
+        ```
 
-# ARM64
-curl -L -o opa https://openpolicyagent.org/downloads/latest/opa_linux_arm64
+    === "Linux"
 
-chmod 755 opa
-sudo mv opa /usr/local/bin/
-```
+        ```bash
+        # AMD64
+        curl -L -o opa https://openpolicyagent.org/downloads/latest/opa_linux_amd64
 
-#### Windows (PowerShell)
+        # ARM64
+        curl -L -o opa https://openpolicyagent.org/downloads/latest/opa_linux_arm64
 
-```powershell
-Invoke-WebRequest -Uri "https://openpolicyagent.org/downloads/latest/opa_windows_amd64.exe" -OutFile "opa.exe"
+        chmod 755 opa
+        sudo mv opa /usr/local/bin/
+        ```
 
-# Add to PATH (run as Administrator or add to user PATH)
-mkdir C:\Tools\OPA
-move opa.exe C:\Tools\OPA\
-[Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\Tools\OPA", "User")
-```
+    === "Windows (PowerShell)"
+
+        ```powershell
+        Invoke-WebRequest -Uri "https://openpolicyagent.org/downloads/latest/opa_windows_amd64.exe" -OutFile "opa.exe"
+
+        # Add to PATH (run as Administrator or add to user PATH)
+        mkdir C:\Tools\OPA
+        move opa.exe C:\Tools\OPA\
+        [Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\Tools\OPA", "User")
+        ```
 
 #### Verify OPA Installation
 

docs/docs/assets/cupcake-light.svg

@@ -5,7 +5,7 @@ description: "Setting up Cupcake with Cursor"
 
 # Cursor Setup
 
-**Important**: Cursor only supports **global** hooks (not project-level). All hooks are configured at `~/.cursor/hooks.json`.
+Cursor only supports **global** hooks (not project-level). All hooks are configured at `~/.cursor/hooks.json`.
 
 ## Project Setup with Global Hooks
 

docs/docs/assets/cupcake-responsive.svg

@@ -9,42 +9,18 @@ After [installation](../installation/), you're ready to set up Cupcake for your
 
 ## Select Your Harness
 
-<div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(140px, 1fr)); gap: 1.5rem; margin: 2rem 0;">
-  <a href="claude-code/" style="text-decoration: none; color: inherit;">
-    <div style="border: 1px solid var(--md-default-fg-color--lightest); border-radius: 8px; padding: 1.5rem; text-align: center;">
-      <img src="../../assets/claude-light.svg#only-light" alt="Claude Code" width="100">
-      <img src="../../assets/claude-dark.svg#only-dark" alt="Claude Code" width="100">
-    </div>
-  </a>
-  <a href="cursor/" style="text-decoration: none; color: inherit;">
-    <div style="border: 1px solid var(--md-default-fg-color--lightest); border-radius: 8px; padding: 1.5rem; text-align: center;">
-      <img src="../../assets/cursor-light.svg#only-light" alt="Cursor" width="100">
-      <img src="../../assets/cursor-dark.svg#only-dark" alt="Cursor" width="100">
-    </div>
-  </a>
-  <a href="opencode/" style="text-decoration: none; color: inherit;">
-    <div style="border: 1px solid var(--md-default-fg-color--lightest); border-radius: 8px; padding: 1.5rem; text-align: center;">
-      <img src="../../assets/opencode-wordmark-light.svg#only-light" alt="OpenCode" width="100">
-      <img src="../../assets/opencode-wordmark-dark.svg#only-dark" alt="OpenCode" width="100">
-    </div>
-  </a>
-  <a href="factory-ai/" style="text-decoration: none; color: inherit;">
-    <div style="border: 1px solid var(--md-default-fg-color--lightest); border-radius: 8px; padding: 1.5rem; text-align: center;">
-      <img src="../../assets/factory.svg" alt="Factory AI" width="100">
-    </div>
-  </a>
-</div>
-
-| Harness         | Status          | Guide                       |
-| --------------- | --------------- | --------------------------- |
-| **Claude Code** | Fully Supported | [Setup Guide](claude-code/) |
-| **Cursor**      | Fully Supported | [Setup Guide](cursor/)      |
-| **OpenCode**    | Fully Supported | [Setup Guide](opencode/)    |
-| **Factory AI**  | Fully Supported | [Setup Guide](factory-ai/)  |
+<!-- If you update this table you should also update it on the homepage! -->
+
+| Harness                                                                                                                                                                              | Status                         | Guide                         |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------ | ----------------------------- |
+| <img src="../../assets/claude-light.svg#only-light" alt="Claude Code" width="90"><img src="../../assets/claude-dark.svg#only-dark" width="90" aria-hidden="true">                    | :lucide-check: Fully Supported | [Setup Guide](claude-code.md) |
+| <img src="../../assets/cursor-light.svg#only-light" alt="Cursor" width="90"><img src="../../assets/cursor-dark.svg#only-dark" width="90" aria-hidden="true">                         | :lucide-check: Fully Supported | [Setup Guide](cursor.md)      |
+| <img src="../../assets/opencode-wordmark-light.svg#only-light" alt="OpenCode" width="90"><img src="../../assets/opencode-wordmark-dark.svg#only-dark" width="90" aria-hidden="true"> | :lucide-check: Fully Supported | [Setup Guide](opencode.md)    |
+| <img src="../../assets/factory-light.svg#only-light" alt="Factory AI" width="100"><img src="../../assets/factory-dark.svg#only-dark" width="100" aria-hidden="true">                 | :lucide-check: Fully Supported | [Setup Guide](factory-ai.md)  |
 
 ## Next Steps
 
 After setting up your harness, learn how to configure policies:
 
-- **[Built-in Policies](../../reference/policies/builtins/)** — Enable pre-built security policies
-- **[Custom Policies](../../reference/policies/custom/)** — Write your own policies in Rego
+- **[Built-in Policies](../../reference/policies/builtins.md)** — Enable pre-built security policies
+- **[Custom Policies](../../reference/policies/custom.md)** — Write your own policies in Rego