generalize use of markdown format