Markdown guides, tutorials, and best practices
Deep-dive articles on writing, editing, and shipping better Markdown. Written by the mdkit team.
How to Use AI + Markdown Templates to Ship Faster
Practical patterns for combining AI assistants with Markdown templates — generate PRDs, post-mortems, docs, and content drafts in a fraction of the time, without losing quality.
Markdown for Bloggers: A Complete Workflow
A start-to-finish Markdown blogging workflow — from capture and drafting to SEO, images, cross-posting, and publishing. Tool-agnostic, optimized for speed and longevity.
How to Write a Post-Mortem / Retrospective
A practical guide to writing blameless post-mortems and retrospectives — timeline construction, root cause analysis, action items that actually get done, and a Markdown template.
How to Write a Product Requirements Document (PRD)
A practical guide to writing PRDs that engineers actually read — structure, examples, anti-patterns, and a Markdown template you can adapt to any product team.
Markdown for Note-Taking: Cornell, Zettelkasten, PARA
Three proven note-taking systems — Cornell, Zettelkasten, and PARA — translated into Markdown workflows you can use in Obsidian, VS Code, or any plain-text editor.
Writing API Documentation in Markdown
A practical guide to writing API docs that developers actually read: structure, auth, endpoint reference, examples, errors, and versioning — with Markdown patterns that scale.
Best Markdown Editors in 2026 (Compared)
A head-to-head comparison of the best Markdown editors in 2026 — VS Code, Obsidian, Typora, iA Writer, Zed, Cursor, and more — with honest trade-offs and recommendations by use case.
GitHub Flavored Markdown (GFM) Explained
What GitHub Flavored Markdown adds on top of standard Markdown: tables, task lists, autolinks, strikethrough, emoji, and platform-specific features. With examples you can use today.
Using Markdown for Technical Writing
Why Markdown is the default format for technical writing in 2026, how to structure docs, and the patterns that keep large docs maintainable over time.
How to Convert HTML to Markdown (Clean, Lossless)
Convert HTML to Markdown cleanly — whether you're migrating a CMS, archiving web pages, or moving to a static site. Tools, gotchas, and how to handle messy input.
How to Convert Markdown to PDF (5 Methods Compared)
Five ways to turn Markdown into a polished PDF — browser tools, Pandoc, VS Code, command-line utilities, and static site exports. Pros, cons, and which to pick.
Markdown vs. HTML: When to Use Which (2026)
A practical comparison of Markdown and HTML — performance, flexibility, portability, and when each is the right tool. With real examples and decision rules.
Markdown Tables: Syntax, Alignment, and Generators
A complete guide to Markdown tables: GFM syntax, column alignment, escaping pipes, nested content, and when to reach for HTML instead. With copy-paste examples.
How to Write a Great GitHub README (With Template)
A complete guide to writing a README that gets stars, attracts contributors, and onboards users in seconds. Structure, tone, badges, screenshots, and a copy-paste template.
The Complete Markdown Cheat Sheet (2026)
Every Markdown syntax you'll ever need, in one reference: headings, lists, tables, code blocks, links, images, task lists, and GitHub extensions. Print-friendly and bookmark-ready.