From copilot-cli-toolkit
Repairs malformed closing fences in markdown files by removing language identifiers. Fixes rendering issues like code blocks bleeding into content or unclosed blocks before commits.
npx claudepluginhub rjmurillo/ai-agentsThis skill uses the workspace's default tool permissions.
Scan and repair malformed closing fences in markdown files. Closing fences must never contain language identifiers.
Repairs malformed closing fences in markdown files by removing language identifiers. Fixes code blocks bleeding into content, incorrect rendering, or unclosed blocks.
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.
Sets up markdownlint-cli2 with pre-commit hooks and .markdownlint.json config for Markdown linting in repos, fixes errors like MD013/MD040/MD060, removes horizontal rules preserving YAML frontmatter.
Share bugs, ideas, or general feedback.
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)