It looks like tables in docs have been slightly improved -
However, still big improvements are needed:
* Background color
* Header formatting
* More column width control
* Cell merging
* Center align tables
* They still look ugly
* ... I could go on and on
At the very least implement something like Typora has - more control, more formatting options and rendering is quite good for markdown tables.