Textový soubor vytvořený pomocí jednoho z několika možných dialektů jazyka Markdown, používá formátování prostého textu, ale zahrnuje vložené textové symboly, které definují, jak formátovat text (např. tučné, zářezy, záhlaví, formátování tabulky), určené pro vytváření prostého textu dokumentaci lze snadno převést do formátu HTML. Soubory .md jsou nejen užitečné pro systémy dokumentace ve formátu HTML, ale také pro zdrojový kód kontrolu verze. To je proto, že soubory mohou být ve srovnání s historickými revizí v čitelném textu (zatímco binární formát nelze snadno porovnat).
Projekty vytvořené pomocí GitHub, populárního on-line systému pro správu verzí, často používají soubor s názvem README.md, který obsahuje “readme” pro projekt. John Gruber, vývojář Markdown, vytvořil program v Perlu pro konverzi Markdown na HTML. Tento program, nazvaný “Markdown,” je k dispozici na internetových stránkách Daring Fireball. POZNÁMKA: markdown soubory se také používají jako rozšíření .MARKDOWN.