Would either md or rST allow for cross-references between the python API documentation and the C++ documentation? I think that would be the biggest feature for me, since it would give a clear way to indicate which functions are intended to only be wrappers.
they both do via references, i believe.