En mi archivo Léame en GitHub, tengo varias imágenes que están presentes en el árbol fuente de mi proyecto al que hago referencia con éxito con directivas como
.. image:: ./doc/source/_static/figs/moon_probe.pngTambién me gustaría que estas imágenes aparezcan cuando se genere este mismo archivo Léame en PyPi.
¿Cómo (a) me aseguro de que las imágenes estén presentes en PyPi para que el archivo Léame acceda y (b) formule la directiva .. image:: para acceder a ellas?
PyPI no leerá las distribuciones de paquetes para la imagen. Tienes que usar el enlace externo de la imagen, por ejemplo:
.. image:: https://raw.githubusercontent.com/greyli/flask-share/master/images/demo.pngSi está utilizando la descripción de Markdown, use esto:
Asegúrese de reemplazar la URL en los ejemplos anteriores con la URL de su imagen, aquí uso la imagen alojada en GitHub, la demostración real está en PyPI .
PD Para obtener el enlace sin formato de la imagen en GitHub, haga clic con el botón derecho en la imagen y elija Copiar dirección de imagen .
Vaya a la dirección de la imagen en el repositorio de Github. La ruta que se muestra será así: https://github.com/tensorbored/kds/blob/master/docs/_static/readme_lift.png
Cambie el término blob en la dirección de la imagen a raw https://github.com/tensorbored/kds/raw/master/docs/_static/readme_lift.png 
Si tiene sus imágenes en Github, navegue hasta la imagen, luego haga clic derecho en el botón de descarga y copie la dirección del enlace:
Luego puede agregarlo en su archivo README.md:
Debe renderizarse correctamente tanto en Github como en PyPi.