GotchasΒΆ
There are some problems one commonly runs into while authoring reST documents:
Separation of inline markup: As said above, inline markup spans must be separated from the surrounding text by non-word characters, you have to use an escaped space to get around that.