Does this skill support automatic linting?

Yes, it integrates with the /md-lint command to format and validate files according to the specified syntax rules after they are written.

Why does this skill restrict emojis and emdashes?

These are restricted to avoid 'AI slop' and ensure a professional, clean aesthetic that remains consistent across different markdown parsers.

How does it handle code blocks?

The skill requires every code block to specify a language (e.g., bash, json, go) to ensure proper syntax highlighting in the rendered output.

Does it manage whitespace?

Yes, the skill enforces single trailing newlines at the end of files and empty lines between different markdown elements like lists and paragraphs.

Can it fix heading structures?

Yes, it mandates using proper heading levels (##, ###) instead of bold text for section titles and requires exactly one H1 per file at the top.

Markdown Syntax Standards

Name: Markdown Syntax Standards
Author: jimweller

byjimweller

0•

Content Management

Enforces standardized Markdown formatting and syntax rules to ensure clean, professional, and consistent documentation.

The Markdown Syntax skill provides a set of rigorous authoring guidelines designed to maintain high-quality documentation within your repository. It enforces technical best practices such as mandatory language tags for code blocks, proper heading hierarchies, and specific spacing rules while stripping away 'AI slop' like emojis and emdashes. This skill is essential for developers and technical writers who need to ensure their documentation is structured correctly for static site generators, README files, and collaborative projects.

Key Features

010 GitHub stars

02Mandatory language tags for all code blocks

03Strict heading hierarchy and H1 placement rules

04Removal of AI-generated stylistic quirks like emojis

05Automated spacing and trailing newline validation

06Integrated workflow with md-lint for final formatting

Use Cases

01Enforcing consistent README standards across multiple repositories

02Standardizing documentation generated by AI to match professional styles

03Preparing markdown files for static site generators like Jekyll or Hugo

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jimweller/davit-dataops-dotfiles md-syntax

For use in Claude.ai and ChatGPT

Key Features

010 GitHub stars

02Mandatory language tags for all code blocks

03Strict heading hierarchy and H1 placement rules

04Removal of AI-generated stylistic quirks like emojis

05Automated spacing and trailing newline validation

06Integrated workflow with md-lint for final formatting

Use Cases

01Enforcing consistent README standards across multiple repositories

02Standardizing documentation generated by AI to match professional styles

03Preparing markdown files for static site generators like Jekyll or Hugo

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jimweller/davit-dataops-dotfiles md-syntax

For use in Claude.ai and ChatGPT