ドキュメント上で動的なURLの記述の仕方

URLの動的な部分を :username や [username] などといった形でURL内に含まれにくい文字で表現していたり、Markdownであれば 斜体 にしているのをよく見るが…

RFC 6570 - URI Template に沿うならば{}で囲ってあげるのが良い。
https://tools.ietf.org/html/rfc6570

     http://example.com/~{username}/
     http://example.com/dictionary/{term:1}/{term}
     http://example.com/search{?q,lang}