Initial commit

skills/markdown-linter-fixer/references/MD036-Guide.md

@@ -0,0 +1,43 @@
+# Markdown Style Guide
+
+## MD036 Rule - No Emphasis as Heading
+
+**Rule**: Never use bold text (`**text**`) as a heading substitute. Always use proper markdown heading syntax.
+
+### ❌ Wrong
+
+```markdown
+**Configuration File Check**
+
+Some content here...
+```
+
+### ✅ Correct
+
+```markdown
+#### Configuration File Check
+
+Some content here...
+```
+
+### Heading Level Guidelines
+
+- Use `#` through `######` for headings (h1-h6)
+- Maintain proper heading hierarchy:
+  - `#` Main title (h1)
+  - `##` Major sections (h2)
+  - `###` Subsections under h2 (h3)
+  - `####` Subsections under h3 (h4)
+- Never skip heading levels (e.g., don't jump from h2 to h4)
+
+### Common Violations to Avoid
+
+1. **Bold text on standalone lines** - These should be headings
+2. **Section dividers using bold** - Use proper heading levels instead
+3. **Emphasis for structure** - Use headings for document structure, bold only for emphasis within content
+
+### When Creating/Modifying Markdown Files
+
+- Always use heading syntax (`####`) for section titles
+- Reserve bold text (`**text**`) for emphasis within paragraphs only
+- Run `markdownlint-cli2` to verify before committing