reST is also designed to have human readable source. You might not like it compared to markdown but it has to serve as a the docstring format of Python and does

reST is also designed to have human readable source. You might not like it compared to markdown but it has to serve as a the docstring format of Python and does so fairly well.