Document only adding links once per paragraph

[willingc]

python/docs-community#52 (comment)

There is general consensus on this. We should add to the markup section of the doc page.