Select Page

Both DITA and Markdown are here to stay! There’s no denying it and it’s actually a good thing.

Both DITA and Markdown serve distinct purposes. It’s important to use the right technologies for the right jobs and avoid creating new silos in the process.

This is possible with a little bit of planning and an open mind!

In July of 2019, Patrick Bosek Presented his case for how DITA and Markdown can co-exist and even thrive in the modern workplace. (Related – 3 Pillars of a Good Content Creation System – How do the different standards compare?)

Who Is This Presentation For?

At a basic level, this presentation is for anyone who needs to use both DITA and Markdown

But who is in this situation?

Most commonly, these companies will be B2B organizations with a relatively complex suite of products, and active development.

Ultimately, this presentation is for organizations that need educated users.

The success of their product is dependent upon their customer’s understanding the product.

Agenda

  • Who is this presentation for? 1:42
  • Overview of DITA and Markdown 5:30
    • Markdown Strengths and Weaknesses 5:43
    • DITA Strengths and Weaknesses 9:10
  • Why We’d Want DITA + Markdown 13:05
    • Harmony Between DITA + Markdown 13:05
    • The Product Life Cycle 14:41
    • Knowledge Doesn’t Have a Source Format 16:22
  • System Architectures for DITA + Markdown 17:16
    • Different Architectures
      • Single Repository 17:36
      • Multiple Repositories (one way) 18:37
      • Bi-directional Multiple Repositories 22:39
    • What Works 23:00
    • What Still Needs Work 28:46
  • Patterns For a Few Common Goals 31:34
  • Questions and Answers 34:36

What are your thoughts? Is Markdown and DITA a viable option within your organization? Let us know your thoughts and/or experiences within this evolving state of tech comm.

Patrick Bosek

Patrick is a co-founder of Jorsek LLC, makers easyDITA. Since beginning with Jorsek LLC in 2005 Patrick, has worked on a wide range of projects all focused on improving authoring, production, and distribution of content. Most recently, his primary focus has been empowering the users of easyDITA and generally advancing the product documentation industry.

Patrick is a software industry professional specializing in developing, productizing, and solving problems with product content software. He is a highly skilled developer, thoughtful manager, passionate customer advocate.

Latest posts by Patrick Bosek (see all)

Get a Demo