Since you asked... Besides tables that can be styled, the ConTeXt writer for pandoc could use captions and cross-references. Those features would allow for high-quality, beautifully typeset technical documentation from Markdown. There's a wealth of information about these, the proposed syntax, and so forth in the issue tracker. Here are some related links:
https://github.com/jgm/pandoc/issues/2106#issuecomment-342613369
https://github.com/jgm/pandoc/issues/2609
https://github.com/jgm/pandoc/issues/813