Next: , Up: Hyperlinks   [Contents][Index]

4.1 Link Format

Org recognizes plain URL-like links and activate them as clickable links. The general link format, however, looks like this:


or alternatively


Once a link in the buffer is complete—all brackets present—, Org changes the display so that ‘DESCRIPTION’ is displayed instead of ‘[[LINK][DESCRIPTION]]’ and ‘LINK’ is displayed instead of ‘[[LINK]]’. Links are highlighted in the org-link face, which, by default, is an underlined face.

You can directly edit the visible part of a link. This can be either the LINK part, if there is no description, or the DESCRIPTION part otherwise. To also edit the invisible LINK part, use C-c C-l with point on the link (see Handling Links).

If you place point at the beginning or just behind the end of the displayed text and press BS, you remove the—invisible—bracket at that location25. This makes the link incomplete and the internals are again displayed as plain text. Inserting the missing bracket hides the link internals again. To show the internal structure of all links, use the menu: Org → Hyperlinks → Literal links.



More accurately, the precise behavior depends on how point arrived there—see (elisp)Invisible Text.