A link to another place in a file, another file, Usenet article, email, etc. Links are categorized as internal or external. (org)Handling Links
‘[[link][Description] ]’ where [Description] is optional
C-c l
(org-store-link)
store a link to the current location (because this is a global
command, you must create a key binding yourself.
cursor on <<target>>
; cursor on headline; :CUSTOM_ID:
property;
link will point to current thing
EWW, W3, W3M link will point to current URL, with page title as description
link will point to the file, with a search string pointing to the contents of the current line; can create custom functions to select the search string.
C-c C-l
create or edit a link; all links stored during the current session are part of
the history; can access them with <UP>
and <DOWN>
(or M-p/n
).
C-u C-c C-l
a link to a file will be inserted; may use file name completion to select
the name of the file. (Force an absolute path with 2 C-u
prefixes).
C-c C-o
or <RET>
follow a link; execute a command in a shell link; run an internal
search; create a TAGS view; compiles an agenda for date; visit an external file; run an
external program (based on file extension); to visit without running, call with a C-u
prefix;
C-c C-x C-v
(org-toggle-inline-image)
C-c &
return to calling position (using Org’s mark ring)
C-c %
Push current position onto the mark ring to make for an easy return.
C-c C-x C-n/p
next/previous link
a link that does not look like a URL is considered an internal link
[[#my-custom-id] ]
, which links to the entry with the
:CUSTOM_ID:my-custom-id
property, which must be unique in the file.
[[My Target][description] ]
performs a text search in the current file. The
preferred match is to a dedicated target, which is the text in double angle
brackets: <<My Target>>
. If there is no dedicated target, then there will
be a search for an exact name: #+NAME: My Target
, placed just before the
element it refers to. Note that you must use the #+CAPTION:
keyword.
Finally, there will be a search for a headline that is exactly the link text,
plus optionally TODO
and tags.
Use in-buffer completion to insert a link targeting a headline: * abc M-<TAB>
Link to a file, website, Usenet, or email message, plus more. An external link is a URL-like locator, starting with a short identifying string and a colon. See 4.3 External Links for a list of examples.