mdlisted
Install: claude install-skill georgekhananaev/claude-skills-vault
# Markdown Clean Skill
Write clean, error-free markdown that IDEs and linters can parse without warnings.
## When to Use
Invoke this skill when:
- Writing markdown documentation
- Creating README files
- Writing skill files with code examples
- Commands: `/md-clean`, `/markdown`
## Common IDE Errors & Fixes
### 1. Nested Code Blocks
**Problem:** Code blocks inside code blocks cause parsing errors.
**Error:** `Newline or semicolon expected`
**Wrong:**
````markdown
```markdown
Here is example:
```js
const x = 1;
```
```
````
**Fix:** Use different fence lengths (4 backticks for outer):
`````markdown
````markdown
Here is example:
```js
const x = 1;
```
````
`````
**Or** use indentation for inner blocks:
````markdown
```markdown
Here is example:
const x = 1;
```
````
### 2. Unclosed Code Blocks
**Problem:** Missing closing fence.
**Error:** `Statement expected`, `Expression expected`
**Wrong:**
```
```js
const x = 1;
// forgot to close
```
**Fix:** Always close with matching fence:
```
```js
const x = 1;
``` <-- closing fence
```
### 3. Mismatched Fence Characters
**Problem:** Opening with backticks, closing with tildes (or vice versa).
**Error:** `Newline or semicolon expected`
**Wrong:**
```
```js
const x = 1;
~~~
```
**Fix:** Match opening and closing:
```
```js
const x = 1;
```
```
### 4. Special Characters in Code Blocks
**Problem:*