File tree Expand file tree Collapse file tree 1 file changed +10
-2
lines changed
doc/usage/restructuredtext Expand file tree Collapse file tree 1 file changed +10
-2
lines changed Original file line number Diff line number Diff line change @@ -208,11 +208,19 @@ Hyperlinks
208
208
External links
209
209
~~~~~~~~~~~~~~
210
210
211
- Use ```Link text <https://domain.invalid/>`_ `` for inline web links. If the
211
+ Use ```Link text <https://domain.invalid/>`__ `` for web links. If the
212
212
link text should be the web address, you don't need special markup at all, the
213
213
parser finds links and mail addresses in ordinary text.
214
214
215
- .. important :: There must be a space between the link text and the opening \< for the URL.
215
+ .. important ::
216
+
217
+ There must be a space between the link text and the opening \< for the URL.
218
+
219
+ Use two trailing underscores when embedding the URL. - Technically, a single
220
+ underscore works as well, but that would create a named reference instead of
221
+ an anonymous one. Named references typically do not have a benefit when the
222
+ URL is embedded. However, they have the disadvantage that you must make sure
223
+ that you do not use "Link text" in another link in your document.
216
224
217
225
You can also separate the link and the target definition (:duref: `ref
218
226
<hyperlink-targets> `), like this::
You can’t perform that action at this time.
0 commit comments