For anyone who has experience with using markdown to write test cases would you recommend it for test cases?

I am specifically thinking instead of the HPQC step - expected - actual style, or given-when-then format for test cases?

2 Answers 2


So - short answer - YES. I recommend it.

I use MD in my test-case documentation quite a bit in JIRA, and as you mention, it is especially useful for making test-structure easy to read. I like to use it especially for given-when-then style notation.

An example of how I use it:

> my test environment has been set up correctly
**and** some other conditions are met

> I push _the big red button_

> _the big red light_ should flash **and** _the alarm_ should sound

results in it being rendered similarly to:


my test environment has been set up correctly and some other conditions are met


I push the big red button


the big red light should flash and the alarm should sound


Check this out, A test case template in markdown! Testcases. md

  • While this link may answer the question, it is better to include the essential parts of the answer here and provide the link for reference. Link-only answers can become invalid if the linked page changes. - From Review
    – Prome
    Sep 13, 2021 at 6:53

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.