Stats
Actions
Tags
From project-toolkit
Repairs malformed closing fences in markdown files by removing language identifiers. Fixes code blocks bleeding into content, incorrect rendering, or unclosed blocks.
How this skill is triggered — by the user, by Claude, or both
Slash command
/project-toolkit:fix-markdown-fencesclaude-haiku-4-5The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Scan and repair malformed closing fences in markdown files. Closing fences must never contain language identifiers.
Scan and repair malformed closing fences in markdown files. Closing fences must never contain language identifiers.
| Trigger Phrase | Operation |
|---|---|
fix markdown fences | Scan and repair malformed fence closings |
repair code block closings | Fix closing fences with language identifiers |
markdown rendering broken | Diagnose and fix fence issues |
code blocks bleeding into content | Fix unclosed or malformed fences |
validate markdown code blocks | Check all fences for correctness |
| Symptom | Cause | Fix |
|---|---|---|
| Code block bleeds into text | Closing fence has language identifier | Remove identifier from closing fence |
| Nested blocks render wrong | Missing closing fence before new opening | Insert closing fence |
| Content cut off at end of file | Unclosed code block | Append closing fence |
Use this skill when:
```python instead of ```)Use manual editing instead when:
Track fence state while scanning line by line:
Regex patterns:
^\s*```[\w+-]+
^\s*```[\w+-]+\s*$
^\s*```\s*$
git diff shows only fence-closing changes, no content modifications| Avoid | Why | Instead |
|---|---|---|
| Manually searching for bad fences | Error-prone in large files | Use the algorithm or grep pattern |
| Copying opening fence line to close a block | Creates the exact bug this skill fixes | Always use plain ``` for closing |
| Fixing fences without tracking block state | Misidentifies nested vs sequential blocks | Use the stateful line-by-line algorithm |
When generating markdown with code blocks:
import re
from pathlib import Path
def fix_markdown_fences(content: str) -> str:
"""Fix malformed code fence closings in markdown content."""
lines = content.splitlines()
result = []
in_code_block = False
block_indent = ""
opening_pattern = re.compile(r'^(\s*)```(\w+)')
closing_pattern = re.compile(r'^(\s*)```\s*$')
for line in lines:
opening_match = opening_pattern.match(line)
closing_match = closing_pattern.match(line)
if opening_match:
if in_code_block:
result.append(f"{block_indent}```")
result.append(line)
block_indent = opening_match.group(1)
in_code_block = True
elif closing_match:
result.append(line)
in_code_block = False
block_indent = ""
else:
result.append(line)
if in_code_block:
result.append(f"{block_indent}```")
return '\n'.join(result)
def fix_markdown_files(directory: Path, pattern: str = "**/*.md") -> list[str]:
"""Fix all markdown files in directory. Returns list of fixed files."""
fixed = []
for file_path in directory.glob(pattern):
content = file_path.read_text()
fixed_content = fix_markdown_fences(content)
if content != fixed_content:
file_path.write_text(fixed_content)
fixed.append(str(file_path))
return fixed
# Find files with potential issues
grep -rEn --include="*.md" -- '```\w+' . | grep -vE "^[^:]*:[0-9]*:[[:space:]]*```\w+[[:space:]]*$"
$directories = @('docs', 'src')
foreach ($dir in $directories) {
Get-ChildItem -Path $dir -Filter '*.md' -Recurse | ForEach-Object {
$file = $_.FullName
$content = Get-Content $file -Raw
$lines = $content -split "`r?`n"
$result = @()
$inCodeBlock = $false
$codeBlockIndent = ""
for ($i = 0; $i -lt $lines.Count; $i++) {
$line = $lines[$i]
if ($line -match '^(\s*)```(\w+)') {
if ($inCodeBlock) {
$result += $codeBlockIndent + '```'
$result += $line
$codeBlockIndent = $Matches[1]
} else {
$result += $line
$codeBlockIndent = $Matches[1]
$inCodeBlock = $true
}
}
elseif ($line -match '^(\s*)```\s*$') {
$result += $line
$inCodeBlock = $false
$codeBlockIndent = ""
}
else {
$result += $line
}
}
if ($inCodeBlock) {
$result += $codeBlockIndent + '```'
}
$newContent = $result -join "`n"
Set-Content -Path $file -Value $newContent -NoNewline
Write-Host "Fixed: $file"
}
}
\n and \r\n as input (normalizes output to \n)npx claudepluginhub rjmurillo/ai-agents --plugin project-toolkitRepairs malformed closing fences in markdown files by removing language identifiers. Fixes rendering issues like code blocks bleeding into content or unclosed blocks before commits.
Runs markdown linting validation on files or all project Markdown using markdownlint-cli2, auto-fixes issues, explains rules, and guides configuration. Ideal for clean docs.
Provides reference for core Markdown syntax: headings, text formatting, lists, links, images, code blocks, blockquotes. Use when writing or editing Markdown files.