DOC: Minor fixes to avoid overful lines in the documentation.
Fixed urls and [|] rendering.