Markdown Docs Markdown editor Try editor

Markdown guides

Markdown files, editors, and AI-ready documentation.

Guides for opening `.md` files, choosing a Markdown editor for Windows, building AI-readable docs, and using Markdown Docs for fast local editing.

Try the online editor Download for Windows

markdown cheat sheet

Markdown Cheat Sheet

A quick Markdown syntax reference: headings, emphasis, lists, links, images, code blocks, tables, task lists, and GitHub Flavored Markdown extensions.

Jun 13, 2026 · 7 min read View

what is llms.txt

What Is llms.txt?

llms.txt is a Markdown file at a site root that tells AI models what the site is about and which pages to reference. A robots.txt for large language models.

Jun 13, 2026 · 6 min read View

ai agent instruction files

AI Agent Instruction Files Explained

AI coding agents read Markdown files to learn how your project works. The complete guide to every .md and rules file, what it does, and when to use it.

Jun 13, 2026 · 10 min read View

what is GEMINI.md

What Is GEMINI.md?

GEMINI.md is a Markdown context file that Google Gemini CLI loads automatically to give the model project instructions, coding style, and persona.

Jun 13, 2026 · 6 min read View

copilot-instructions.md

What Is copilot-instructions.md?

copilot-instructions.md gives GitHub Copilot repository-wide custom instructions so it follows your coding standards automatically across the repo.

Jun 13, 2026 · 6 min read View

cursor rules

What Are Cursor Rules?

Cursor rules are Markdown instruction files that tell the Cursor AI editor how to write code, using the modern .cursor/rules .mdc system with glob scoping.

Jun 13, 2026 · 7 min read View

windsurf rules

What Are Windsurf Rules?

Windsurf rules are Markdown instructions that guide Cascade, the Windsurf AI agent, so it writes code that matches your project conventions.

Jun 13, 2026 · 6 min read View

what is CONVENTIONS.md

What Is CONVENTIONS.md?

CONVENTIONS.md is a free-form Markdown file that documents the coding rules an AI coding agent should follow inside a repository, across multiple tools.

Jun 13, 2026 · 6 min read View

what is SKILL.md

What Is SKILL.md?

SKILL.md is the Markdown file that defines an Agent Skill: YAML frontmatter that tells the agent when to use it, plus the instructions the agent follows.

Jun 13, 2026 · 7 min read View

how to create a SKILL.md file

How to Create a SKILL.md File

Build an Agent Skill from scratch: the folder layout, how to name it, the YAML frontmatter, the instructions, supporting files, and a complete example.

Jun 13, 2026 · 9 min read View

what is CHANGELOG.md

What Is CHANGELOG.md?

CHANGELOG.md is a Markdown file that records what changed in each version of a project, so people and tools can see its history at a glance.

Jun 13, 2026 · 6 min read View

what is CONTRIBUTING.md

What Is CONTRIBUTING.md?

CONTRIBUTING.md is a Markdown file that tells contributors how to work on a project: setup, branch and pull request rules, and review expectations.

Jun 13, 2026 · 6 min read View

what is TODO.md

What Is TODO.md?

TODO.md is a Markdown file that holds a project task list, backlog, or implementation checklist in plain text that lives next to the code.

Jun 13, 2026 · 5 min read View

what is PROMPTS.md

What Is PROMPTS.md?

PROMPTS.md is a Markdown file that collects reusable AI prompts and prompt patterns so a team can reuse what works instead of rewriting prompts each time.

Jun 13, 2026 · 5 min read View

what is API.md

What Is API.md?

API.md is a Markdown file that documents a project API: endpoints, request and response examples, payloads, and authentication, kept next to the code.

Jun 13, 2026 · 5 min read View

what is SECURITY.md

What Is SECURITY.md?

SECURITY.md is a Markdown file that tells people how to report a security vulnerability in your project and what your security policy is.

Jun 13, 2026 · 6 min read View

markdown files in AI age

Why Markdown Files Matter in the AI Age

Markdown is no longer just a developer convenience. In AI workflows, .md files are portable, token-efficient, easy to diff, and simple for humans and agents to read.

Jun 13, 2026 · 7 min read View

Markdown vs Word for AI documentation

Markdown vs Word for AI Documentation

Word is excellent for polished documents, but Markdown is usually better for AI-readable documentation, version control, prompts, and developer knowledge bases.

Jun 13, 2026 · 7 min read View

online markdown editor live preview

Online Markdown Editor with Live Preview

Online Markdown editors are useful when you need a fast browser preview, a clean copy-paste workspace, or a way to test Markdown before saving a file locally.

Jun 13, 2026 · 6 min read View

how to use Markdown files with AI

How to Use Markdown Files with AI Tools

Markdown works well with AI because it keeps instructions, examples, headings, and code in a structured plain-text format that models can read clearly.

Jun 13, 2026 · 8 min read View

what is README.md

What Is README.md?

README.md is the front door of a project. It explains what the project does, how to use it, and gives humans and AI tools the first layer of context.

Jun 13, 2026 · 6 min read View

what is AGENTS.md

What Is AGENTS.md?

AGENTS.md is like a README for coding agents: a predictable Markdown file for setup commands, test rules, project style, and agent instructions.

Jun 13, 2026 · 7 min read View

what is CLAUDE.md

What Is CLAUDE.md?

CLAUDE.md gives Claude persistent project instructions in plain Markdown, helping each session start with the right context and workflow rules.

Jun 13, 2026 · 7 min read View

what is DESIGN.md

What Is DESIGN.md?

DESIGN.md is a practical Markdown file for recording design intent, architecture choices, UI decisions, constraints, and trade-offs before implementation.

Jun 13, 2026 · 6 min read View

common .md files for AI projects

Common .md Files for AI and Software Projects

Modern AI and software projects often use multiple Markdown files: README.md for humans, AGENTS.md for agents, CLAUDE.md for Claude, and DESIGN.md for decisions.

Jun 13, 2026 · 9 min read View

Need a Markdown editor right now?

Use the browser editor for quick previews, or install Markdown Docs to open `.md` files directly from Windows.

Get Markdown Docs