API documentation is essential for a good user experience, and incorporating Markdown can significantly enhance its quality by adding readability and contextual richness. Markdown, a lightweight markup language, is particularly effective in API documentation, allowing for text formatting such as bold and italics to highlight crucial information, and hyperlinks to direct users to additional resources without cluttering the main content. OpenAPI supports Markdown in description fields, enabling detailed explanations while summary fields remain plain text for concise listings. Inline Markdown improves user comprehension, as illustrated by examples from GitHub and Stripe APIs, which use code markup, hyperlinks, and multiline formatting to enrich descriptions and make complex instructions more accessible. By maximizing the potential of description fields with Markdown, API documentation becomes more informative and user-friendly, thereby enhancing the overall user experience.