Posts

Showing posts from June, 2026

Using DITA Conditional Text in Markdown Files

Image
One of the advantages of DITA is the ease in which you can apply conditional text. Because, in most instances, I use markdown when working with DITA Open Toolkit (DITA-OT), I wanted to see how well conditional text works in markdown files. In DITA-OT, you can apply conditional text to markdown files. I will show some examples in this post. Create Markdown Files First, we'll populate three markdown files: first.md # First Section   This document shows the use of conditional text in markdown files. second.md # Second Section   This is the second section. conditions.md # Conditions   This is a test.   This paragraph is visible to <span audience="novice">novice</span><span audience="expert">expert</span> users.   This paragraph is only for novice users. {audience="novice"}   This paragraph is only for advanced users. {audience="expert"}     ## Table {audience="expert"} | Header 1 | Header 2 | Header 3 | | -------...