Why do `---` dividers cause odd formatting in test cases?
Question
I use --- as a divider in my test cases, but it sometimes breaks the formatting. Why?
Answer
The Classical editor uses Markdown, where --- has two different meanings depending on what comes before it.
On its own line with a blank line above it, --- is a divider. But placed directly under a line of text, it becomes heading syntax: it turns the line above into a heading, and the divider itself disappears.
Select the tab from the top navigation---A blank line before --- prevents this and gives you the divider you expect:
Select the tab from the top navigation
---The problem is that the Rich editor removes that blank line when you add or edit steps. So a template that rendered correctly turns into a heading once you touch it in the Rich editor.
Workaround
Section titled “Workaround”Use *** or ___ instead of ---. These only ever mean “divider”, they have no heading meaning, so they render correctly even if the blank line is removed:
Select the tab from the top navigation***You can also re-add the blank line in the Markdown tab, but editing that test again in the Rich editor may strip it out once more. Switching to *** is the more durable fix.