Why are emojis and em-dashes restricted?

These are restricted to prevent 'AI slop' and maintain a minimalist, professional technical tone suitable for engineering documentation.

Can I have multiple H1 headers in a single file?

No, this skill enforces a single H1 header at the very top of the file to follow web and documentation best practices.

Why is specifying a language on code blocks mandatory?

Specifying a language (like bash, json, or go) ensures that syntax highlighting renders correctly across different platforms and editors.

Does this skill support automatic linting?

The skill provides guidelines for Claude's writing behavior and recommends using the /md-lint command to verify and format files after they are written.

Markdown Syntax & Style Guide

Name: Markdown Syntax & Style Guide
Author: jimweller

byjimweller

0•

Learning & Documentation

Enforces professional Markdown formatting and structural rules to ensure clean, consistent, and high-quality documentation.

The md-syntax skill provides a rigorous set of authoring guidelines for Claude to follow when creating or editing Markdown files. It focuses on structural integrity, such as enforcing a single H1 header per file and proper heading hierarchies, while eliminating 'AI slop' like emojis and em-dashes. By requiring explicit language tags for code blocks and specific spacing between elements, this skill ensures that all generated documentation is professional, highly readable, and compatible with standard linting tools.

Key Features

01Enforces mandatory language tagging for all code blocks

02Standardizes heading hierarchy and H1 placement

03Ensures consistent spacing between paragraphs and styles

04Mandates trailing newlines for file termination

05Removes stylistic 'slop' such as emojis and em-dashes

060 GitHub stars

Use Cases

01Standardizing documentation across a technical repository

02Cleaning up AI-generated text for professional publication

03Ensuring markdown compatibility with static site generators

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

01Enforces mandatory language tagging for all code blocks

02Standardizes heading hierarchy and H1 placement

03Ensures consistent spacing between paragraphs and styles

04Mandates trailing newlines for file termination

05Removes stylistic 'slop' such as emojis and em-dashes

060 GitHub stars

Use Cases

01Standardizing documentation across a technical repository

02Cleaning up AI-generated text for professional publication

03Ensuring markdown compatibility with static site generators

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