In-depth guides for writing Markdown across the tools you already use.
30 Mermaid diagram examples to copy: flowchart, sequence, state, ER, class, Gantt, mind map, pie and more, with previews and downloadable source files.
Convert a Word .docx file to clean Markdown with Pandoc or MarkItDown. Tested commands, what carries over, what is lost and how to fix the result.
macOS shows .md files as plain text in Quick Look. We tested 5 Markdown preview extensions (Markdific, QLMarkdown and more), plus setup and fixes.
Markdown is a plain-text formatting language. How it works, where it came from, where it is used, and how to start writing it.
Ten short lessons on headings, bold, lists, links, images, code, quotes, tables and task lists, then a complete practice document.
12 Mac Markdown editors tested on macOS 15.7, plus 6 Quick Look previews in Finder: rendering, autosave, line endings, speed and memory, with Homebrew commands.
10 Windows Markdown editors tested on Windows Server 2022: rendering, autosave, line endings, speed and memory, with winget commands for each.
17 Linux Markdown editors tested on Ubuntu 24.04: rendering, autosave, line endings, speed and memory, with install commands for each.
Compare AGENTS.md, CLAUDE.md, GEMINI.md, Cursor and Windsurf rules, Copilot instructions and prompt files, SKILL.md, DESIGN.md, and llms.txt.
Use Markdown in Jira Cloud work-item descriptions and comments. Includes supported syntax, examples, code blocks, wiki markup differences, and fixes.
Create reusable GitHub Copilot prompt files with .github/prompts/*.prompt.md, front matter, inputs, file references, examples, testing, and limits.
Use Markdown-style formatting in Microsoft Teams chats and channels. Includes supported syntax, code blocks, examples, mobile limits, and fixes.
Create effective Cursor project rules with .mdc files, rule types, globs, nested rules, examples, migration from .cursorrules, and troubleshooting.
Create Windsurf rules with current .devin/rules and legacy .windsurf/rules locations, activation modes, AGENTS.md support, examples, and fixes.
Learn how to write CLAUDE.md for Claude Code, with file locations, loading rules, imports, path-specific rules, a complete template, and troubleshooting.
Learn how GEMINI.md works in Gemini CLI, with file locations, hierarchy, imports, memory commands, custom filenames, a complete template, and troubleshooting.
Create an Agent Skill with SKILL.md. Learn the required YAML fields, folder structure, progressive disclosure, validation, security, and a complete example.
Create .github/copilot-instructions.md for GitHub Copilot, with a complete template, path-specific instructions, scope rules, verification, and troubleshooting.
Learn the llms.txt format with a complete example, publishing steps, validation checks, and an honest explanation of what it does not do for Google rankings.
Learn how DESIGN.md gives coding agents reusable design context, with the format, an example, CLI commands, exports, common mistakes, and practical limits.
Learn how to write an effective AGENTS.md, with a copyable template, monorepo rules, concrete examples, common mistakes, and maintenance guidance.
How to write a README file in Markdown: what to include, a section-by-section structure, formatting with headings, badges, tables, and images, plus examples.
How to format Discord text with Markdown: bold, italic, underline, strikethrough, spoilers, code blocks, quotes, headers, lists, and examples.
How to use Markdown in Jupyter Notebook cells: headings, lists, tables, images, LaTeX math, and line breaks, plus how to create and render a Markdown cell.
How Markdown works in Confluence Cloud: current editor shortcuts, legacy Markdown insertion, import limits, and why pages are not stored as Markdown.
How Markdown works in Slack messages, app-published mrkdwn, and the Block Kit markdown block, with syntax examples and current limitations.
How Markdown works in Notion: the typing shortcuts that format blocks, how to import .md files, and what happens to formatting when you export back to Markdown.
A practical Obsidian Markdown guide covering formatting, wikilinks, embeds, callouts, properties, tags, block references, portability, and common fixes.
How to write Markdown in VS Code: use preview, outline and link tools, render Mermaid and math, and understand where extensions help.
How to write Markdown on GitHub: headings, tables, task lists, alerts, diagrams, collapsible sections, and README tips, with GitHub-specific rules.