Taken from a post by Stuart Colville at https://muffinresearch.co.uk/selectively-including-parts-readme-rst-in-your-docs/. Here only to make this star-able by myself.
In your README.rst
add a marker marking from which point you want to start importing content:
Blah blah project
=================
Here's all the actual readme content.