while we are actually using a CommonMark renderer instead of Markdown, i think i just prefer referring to everything related to this as "markdown" for simplicity's sake. meh.
yaml is just easier to write by hand, and since we're using it for files which are all meant to be written/edited by hand, it seems like a no-brainer.