How does this skill handle file endings?

It enforces a single trailing newline at the end of every markdown file to ensure consistent file termination.

Can I use bold text as a section title?

No, the skill enforces the use of proper markdown heading levels (##, ###) instead of bolding text on a single line to maintain document structure.

How do I verify the formatting after writing?

The skill guidelines recommend running an md-lint command to format and validate the file after the content has been authored.

Why does this skill prohibit emojis and emdashes?

The skill follows a 'No AI slop' policy to ensure a professional tone and maximum compatibility across documentation platforms that may handle special characters inconsistently.

Do I need to specify the language for every code block?

Yes, this skill requires specific language tags like bash, yaml, or go for every code block to ensure proper rendering and syntax highlighting.

Markdown Syntax & Formatting

Name: Markdown Syntax & Formatting
Author: jimweller

byjimweller

0•

Content Management

Enforces strict markdown syntax rules and formatting standards to ensure clean, professional, and AI-optimized documentation.

The md-syntax skill provides a comprehensive set of authoring guidelines designed to standardize markdown documentation within your workflow. It ensures structural integrity by enforcing rules such as mandatory language tags for code blocks, proper heading hierarchies, and consistent spacing between elements. By eliminating decorative elements like emojis and ensuring a single H1 per file, this skill helps developers and technical writers maintain a professional, 'slop-free' documentation style that is fully compatible with automated linting tools and documentation generators.

Key Features

01Mandatory language tagging for all code blocks to ensure proper syntax highlighting

02Enforcement of proper heading hierarchies (H2, H3) over bold section titles

03Strict 'No AI slop' policy that removes emojis and emdashes for professional clarity

04Structural rules requiring a single H1 title at the top of every document

05Consistent spacing requirements between different markdown elements and styles

060 GitHub stars

Use Cases

01Standardizing technical documentation across large, multi-contributor repositories

02Preparing markdown files for integration with automated static site generators

03Enforcing a professional brand voice by eliminating non-standard characters and formatting

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

01Mandatory language tagging for all code blocks to ensure proper syntax highlighting

02Enforcement of proper heading hierarchies (H2, H3) over bold section titles

03Strict 'No AI slop' policy that removes emojis and emdashes for professional clarity

04Structural rules requiring a single H1 title at the top of every document

05Consistent spacing requirements between different markdown elements and styles

060 GitHub stars

Use Cases

01Standardizing technical documentation across large, multi-contributor repositories

02Preparing markdown files for integration with automated static site generators

03Enforcing a professional brand voice by eliminating non-standard characters and formatting