embed references in definition/example/comment