The man page doesn’t say what happens to the output. As far as I can tell, it is always written to stdout. It would be nice to add a sentence: “Markdown reads its input from the given files and writes its output to standard output.” And perhaps also to add: “This means that to convert more than one file to HTML, it should be run once per input file, unless the aim is really to concatenate the outputs.”