ReadMe is transitioning from its hybrid documentation format, which combines Markdown and proprietary "magic blocks," to a new ReadMe-flavored Markdown syntax that simplifies the authoring process and improves compatibility with standard Markdown expectations. Originally, the "magic blocks" provided a unique and rich documentation experience by allowing JSON-based components within Markdown, but as the web evolved, this format became cumbersome, hindering features like GitHub sync and PDF exports. The new syntax aims to modernize ReadMe's documentation by extending standard Markdown with syntax extensions, allowing for easier parsing and rendering of components like tabbed code blocks without the syntactical complexity of the previous format. This change is intended to enhance usability and maintain backward compatibility, bridging the gap between ReadMe's original format and modern developer expectations, with an initial public preview now available for user feedback.