format_markdown SKILL.md skillA

format_markdown from theafh/ai-modules is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add theafh/ai-modules/format_markdown@v2.0.0

Pins v2.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
theafh/ai-modules
Path
plugins/ai_dev/skills/format_markdown/SKILL.md
Versions recorded
1
Latest version
v2.0.0, committed May 3, 2026
Size
1,348 bytes
Repository stars
39
License
MIT

Apply markdown linting compliance and best practices when creating or editing markdown files (.md, .mdc). Covers blank-line rules around block elements, consistent bullet style, fenced code blocks with language identifiers, table alignment syntax, header level progression, list indentation and spacing, and link/image conventions.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# format_markdown

## Linting Compliance

- **Blank lines**: One around headings, lists, tables, code blocks
- **Single newline**: File must end with exactly one newline
- **No multiple blanks**: Maximum one consecutive blank line
- **Consistent bullets**: Use `-` for all unordered lists
- **Fenced code**: Always use language identifier
- **Table alignment**: Use `:---:` for center, `:---` for left, `---:` for right
- **Header levels**: Don't skip levels (H1 → H2 → H3, not H1 → H3)
- **List indentation**: 2 spaces for nested items
- **List marker spacing**: Use 1 space after list markers
- **No bare URLs**: Wrap in angle brackets or use reference links
- **No trailing punctuation**: In headers

## Best Practices

- **Descriptive links**: Meaningful text, not "click here"
- **Alt text**: Always for images
- **Consistent emphasis**: `**bold**` and `*italic*` only
- **Table headers**: Always include

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add theafh/ai-modules/format_markdown@sha256:1c822d6651a7f7ba

The line at the top of this page pins the label v2.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_cuy7jvq7lxtkmhwi.svg)](https://markdownregistry.com/a/art_cuy7jvq7lxtkmhwi)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on May 3, 2026.

versioncommittedcommitsizeaudit
v2.0.0 latest2026-05-03 218abb8 1,348 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (1348 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

theafh/ai-modules · 39 stars · license MIT · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_cuy7jvq7lxtkmhwi
GET https://markdownregistry.com/api/v1/resolve?ref=theafh/ai-modules/format_markdown
GET https://markdownregistry.com/api/v1/blob/1c822d6651a7f7ba43435d22e4c31c327434dcbbfcf535ad912f16c7247ebbea

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from theafh/ai-modules

AGENTS.md AGENTS.md file
theafh/ai-modules · AGENTS.md
git:20261105.f9e2714 · audit A · 39 stars
CLAUDE.md CLAUDE.md file
theafh/ai-modules · CLAUDE.md
git:20261104.20c4246 · audit A · 39 stars
agent_spinner SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/agent_spinner/SKILL.md · Run helper agents from an orchestrating agent under one quality contract, whatever delegation the host offers…
v1.0.3 · audit A · 39 stars
ai_instruction_formatting SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/ai_instruction_formatting/SKILL.md · Organize AI-consumed content (prompts, rules, skills, commands, agents, system instructions) into pseudo-XML by…
v3.4.3 · audit A · 39 stars
ai_instruction_writing SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/ai_instruction_writing/SKILL.md · Write AI-consumed content using positive, action-oriented language as the primary carrier of every instruction. Use…
v3.0.4 · audit A · 39 stars
format_python SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/format_python/SKILL.md · Apply formatting standards, code quality rules, structure conventions, linting prevention, and best practices when…
v1.4.1 · audit A · 39 stars
format_rust SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/format_rust/SKILL.md · Apply clippy-aligned Rust practices when writing or editing Rust code (.rs). Covers procedural flow, clippy-driven…
v1.3.2 · audit A · 39 stars
git_auto_review SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/git_auto_review/SKILL.md · Run an automated review-and-fix loop over the checked-out branch's change since the default branch plus its working…
v1.0.12 · audit B · 39 stars
git_checkout SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/git_checkout/SKILL.md · Put the repository onto an existing branch wherever it lives: fetch every remote without pruning, switch when the…
v1.0.0 · audit A · 39 stars
git_commit SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/git_commit/SKILL.md · Create one structured git commit covering the full current working-tree state. Use when the user explicitly asks to…
v3.5.2 · audit B · 39 stars
git_refresh SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/git_refresh/SKILL.md · Refresh a local git repo back to a clean current default branch: fetch/prune, detect the remote HEAD, fast-forward…
v1.0.1 · audit A · 39 stars
git_review SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/git_review/SKILL.md · Review the changes the user names and answer two questions kept apart: could they be approved in general, and can they…
v1.0.16 · audit B · 39 stars

Every file in theafh/ai-modules

Browse by kind, by grade A, or by owner.