Some links will become broken in GitHub.

Imitate readthedocs

Imitate GitHub markdown rendering

Fixes diagrams URL in DOM

But some examples are to be filled in.