Pros and Cons of Using Markdown for Technical Documentation Panel Discussion

Presented by

Ed Marsh, Eric Holscher, and Fabrizio Ferri-Benedetti > Hosts: Patrick Bosek and Scott Abel

About this talk

Join us for a panel discussion about the pros and cons of tech docs shops using Markdown, a lightweight markup language with plain-text formatting syntax that is designed to be converted to HTML and other formats using markup conventions. We'll discuss Markdown's pros, cons, strengths, and limitations in creating tech docs. We'll also address misconceptions about its adoption, its value, and its drawbacks. Additionally, we'll explore the time writers spend on tooling versus content creation to maintain the publishing pipeline. Our panelists will share their views, personal experiences, and anecdotes. Come prepared to ask questions. Panelists include: Ed Marsh — A seasoned content strategist and tech comm specialist with a wealth of experience in developing content that resonates with audiences and enhances user experiences. His expertise spans across various industries, providing a broad perspective on content strategy and its impact on customer engagement. Eric Holscher, co-founder of Read the Docs, Write the Docs, and EthicalAds — Eric is a visionary in the documentation community. His work focuses on improving the quality and accessibility of tech docs, making him a pivotal figure in discussions about the future of content production and management. Fabrizio Ferri-Benedetti, a writer with a rich background in tech writing and content strategy, Fabrizio is known for his innovative approaches to content creation and documentation. His insights into the challenges and opportunities will be invaluable for technical docs pros looking to optimize their content workflows. Can’t make it? Register, and we’ll send you a link you can use to watch a recording when it’s convenient for you. Coffee and Content is brought to you by The Content Wrangler and is sponsored by Heretto, a powerful component content management system (CCMS) platform to deploy help and API documentation in a single portal designed to delight your customers.
Related topics:

More from this channel

Upcoming talks (51)
On-demand talks (678)
Subscribers (73884)
The Content Wrangler Channel covers the people, methods, tools and technologies designed to help you deliver the right information, to the right people, at the right time, on the right device, in the right format and language. Your content is your most valuable business asset. Let us show you how to manage it efficiently and effectively.