Does this skill enforce a specific file start?

Yes, it requires that the very first line of every markdown file be a single H1 title to ensure structural consistency.

How does this skill handle code blocks?

It requires every code block to have a specific language identifier, such as bash, yaml, or json, to ensure proper rendering and syntax highlighting.

What does 'No AI slop' mean in this context?

It refers to the removal of unnecessary emojis and emdashes that are often overused by AI, ensuring the documentation remains professional and concise.

Why should I use headings instead of bold text for sections?

Using proper heading levels (##, ###) is essential for document structure, accessibility, and generating accurate tables of contents.

Can this skill format my files automatically?

The skill provides the logic and rules for formatting; it specifically prompts the use of the /md-lint command to apply these changes and validate the file.

Markdown Syntax Standards

Name: Markdown Syntax Standards
Author: jimweller

byjimweller

0•

Gestión de Contenido

Enforces strict markdown formatting rules and best practices for clean, professional documentation.

The Markdown Syntax skill provides a robust set of authoring guidelines to ensure consistency across your project's markdown files. It automates the adherence to structural rules such as mandatory language tags for code blocks, proper heading hierarchy, and specific spacing requirements. By prohibiting 'AI slop' like unnecessary emojis and enforcing rigorous H1 usage, this skill helps developers maintain professional, lint-ready documentation that integrates seamlessly with automated tools and static site generators.

Características Principales

01Strict heading hierarchy enforcement over bold text sectioning

02Mandatory code block language tagging for syntax highlighting

03Precise whitespace and trailing newline optimization

04Standardized H1 title structure and placement validation

05Removal of non-professional elements like emojis and emdashes

060 GitHub stars

Casos de Uso

01Ensuring high-quality technical writing free from AI stylistic artifacts

02Preparing markdown files for automated linting and CI/CD pipelines

03Standardizing technical documentation across a large repository

Características Principales

01Strict heading hierarchy enforcement over bold text sectioning

02Mandatory code block language tagging for syntax highlighting

03Precise whitespace and trailing newline optimization

04Standardized H1 title structure and placement validation

05Removal of non-professional elements like emojis and emdashes

060 GitHub stars

Casos de Uso

01Ensuring high-quality technical writing free from AI stylistic artifacts

02Preparing markdown files for automated linting and CI/CD pipelines

03Standardizing technical documentation across a large repository