I agree that the markup format is a bikeshed--I think that choice should be entirely governed by what the standard toolchain for this process is. AFAIK that's still Sphinx