Document only adding links once per paragraph

https://github.com/python/docs-community/issues/52#issuecomment-1925884904

There is general consensus on this. We should add to the markup section of the doc page.

