diff --git a/.github/workflows/lint-md-links.yml b/.github/workflows/lint-md-links.yml
index 324728b..bcdbb79 100644
--- a/.github/workflows/lint-md-links.yml
+++ b/.github/workflows/lint-md-links.yml
@@ -13,5 +13,5 @@ permissions:
 
 jobs:
   lint:
-    uses: qte77/.github/.github/workflows/lint-md-links.yml@5dfff1f73ac7241ef37b6103e04d2a8373ff68a4  # 2026-04-27
+    uses: qte77/.github/.github/workflows/lint-md-links.yml@55ea1a9910b7dfe02853437345fd76c009cb858f  # 2026-04-27
 ...
diff --git a/CLAUDE.md b/CLAUDE.md
index 5d601f0..5023f76 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -16,7 +16,7 @@ Upstream dual-license: **AGPLv3 + Enterprise Commercial**. See `LICENSE`.
 make validate        # typecheck + lint + compile + test (full gate)
 make validate_quick  # typecheck + lint (fast gate for iteration)
 make ralph_run ITERATIONS=5       # run ralph TDD loop
-```
+```bash
 
 See `AGENTS.md` for agent role boundaries.
 
diff --git a/README.md b/README.md
index 6c7194b..a7f63b9 100644
--- a/README.md
+++ b/README.md
@@ -76,19 +76,19 @@ Your generated designs are saved locally inside `.superdesign/`.
 
 ## ❓ FAQ
 
-**Is it free and open source?**  
+### Is it free and open source?
 Yes! We are open source — fork it, extend it, remix it.
 
-**Can I customize the design agent?**  
+### Can I customize the design agent?
 Yes — use your own prompt templates, modify behaviors, or add commands.
 
-**Can SuperDesign update existing UI?**  
+### Can SuperDesign update existing UI?
 Absolutely — select a component, describe the change, and let the agent do the rest.
 
 <img width="886" height="586" alt="image" src="https://github.com/user-attachments/assets/71b7cfcc-6123-40ea-aae5-05ea6cdcea96" />
 
 
-**How can I contribute?**  
+### How can I contribute?
 Pull requests are welcome. Star the repo and join us on [Discord](https://discord.gg/FYr49d6cQ9)!
 
 ---
diff --git a/deploy_note.md b/deploy_note.md
index 78e3804..87dac3e 100644
--- a/deploy_note.md
+++ b/deploy_note.md
@@ -21,7 +21,7 @@ This guide covers how to publish updates to both the new official publisher (`Su
 ### Required Tools
 ```bash
 npm install -g @vscode/vsce ovsx
-```
+```text
 
 ---
 
@@ -52,9 +52,9 @@ npx vsce publish --pat YOUR_VSCE_TOKEN
 
 # Publish to Open VSX Registry
 npx ovsx publish -p YOUR_OVSX_TOKEN
-```
+```bash
 
-**Or all in one command:**
+### Or all in one command:
 ```bash
 npm run package && \
 npx vsce publish --pat YOUR_VSCE_TOKEN && \
@@ -91,7 +91,7 @@ Only publish to `iganbold` when:
   "version": "0.0.X",  // Match or increment from last iganbold version
   "publisher": "iganbold"
 }
-```
+```javascript
 
 2. **Update `src/extension.ts` (line ~1327):**
 ```typescript
@@ -117,7 +117,7 @@ This extension has moved to a new publisher account. Please uninstall this versi
 
 [... rest of deprecation message ...]
 EOF
-```
+```bash
 
 ### Step 2: Commit and Tag
 
@@ -163,7 +163,7 @@ mv README_ORIGINAL.md README.md
 git add -A
 git commit -m "Revert to SuperdesignDev publisher for ongoing development"
 git push origin main
-```
+```bash
 
 ---
 
@@ -228,7 +228,7 @@ jobs:
       - run: npm install -g @vscode/vsce ovsx
       - run: vsce publish --pat ${{ secrets.VSCE_TOKEN }}
       - run: ovsx publish -p ${{ secrets.OPEN_VSX_TOKEN }}
-```
+```bash
 
 ### GitHub Secrets
 
@@ -257,15 +257,15 @@ npx ovsx publish -p YOUR_OVSX_TOKEN
 git tag v0.0.X && git push origin main && git push origin v0.0.X
 # 3. Wait for GitHub Actions
 # 4. Revert changes
-```
+```text
 
 ### Check Published Versions
 
-**SuperdesignDev (New):**
+### SuperdesignDev (New):
 - VS Code: https://marketplace.visualstudio.com/items?itemName=SuperdesignDev.superdesign-official
 - Open VSX: https://open-vsx.org/extension/SuperdesignDev/superdesign-official
 
-**iganbold (Old - Deprecated):**
+### iganbold (Old - Deprecated):
 - VS Code: https://marketplace.visualstudio.com/items?itemName=iganbold.superdesign
 - Open VSX: https://open-vsx.org/extension/iganbold/superdesign