markdown-formatting

name: markdown-formatting description: >- Ensures markdown files follow project conventions including Torchlight code tags and markdown-lint rules. Activates when creating or editing markdown files.

Markdown Formatting

Activate this skill when:

Activate when writing or editing any markdown files.

General Guidelines

• Do not include table of contents unless specifically requested.

Code Blocks

All code blocks must include a language tag and a flag for syntax highlighting and preview features.

Other Flags: +preview, +collapse and output exist but are less common and only to be used when requested.

Demo-Folded Wrapper Class

When using +demo-folded, add class="bx" to wrap the example in a box component:

```html +demo-folded class="bx"
<div class="example">Content here</div>

Language Tags

Use the tag that matches the content, unless specified otherwise:

Horizontal

Use 80 hyphens ------------------------------------------------------------------------------- for horizontal rules.

Lists

• Use hyphens - for unordered lists
• Use numbers 1. 2. for ordered steps
• Consistent indentation (4 spaces)

Tables

Standard GitHub Flavored Markdown:

• Keep separators aligned

Linting

• Blank line before and after