diff --git a/doc/org-manual.org b/doc/org-manual.org index 95846b4758..e904b27db2 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -11780,20 +11780,19 @@ ** Literal Examples ** Images and link previews :PROPERTIES: -:DESCRIPTION: Preview links in the buffer +:DESCRIPTION: Preview links in the buffer. :END: -Org mode can display previews of hyperlinks (see [[*Hyperlinks]]) -inside Org buffers. By default, only image links[fn::Image links are -=file:= and =attachment:= links to existing image files; Emacs can -only display the linked images listed in ~image-types~ variable] can -be previewed inline, where the images are displayed in place of the -link path. +Org mode can display previews of [[*Hyperlinks][hyperlinks]] inside Org buffers. By +default, only image links[fn::Image links are =file:= and +=attachment:= links to existing image files; Emacs should be able to +display the linked images (see ~image-types~ variable)] can be +previewed inline, where the images are displayed in place of the link +path. -You can customize the previews as described in [[*Adding Hyperlink -preview]]. Link previews do not have to display images -- any kind of -display decoration (see [[info:elisp#Overlay Properties]]) can be -used. +You can customize the previews as described in the [[*Adding Hyperlink +preview]] section. Link previews do not have to display images -- any +kind of [[info:elisp#Overlay Properties][display decoration]] can be used. You can preview the supported link types in the whole buffer, in the current section, active region or at point with the following commands: @@ -11802,12 +11801,11 @@ ** Images and link previews #+kindex: C-c C-x C-v #+findex: org-link-preview - Create inline previews for external links in the active region, if - any; the link at point, if there is such; or in the current section - otherwise. With a prefix argument, clear link previews at point or - in the current entry. With a double prefix argument, preview all - links in the buffer. With triple prefix argument, hide previews for - all links in the buffer. + Create inline previews for external links in the active region, the + link at point or in the current section. With a prefix argument, + clear link previews at point or in the current entry. With a double + prefix argument, preview all links in the buffer. With triple + prefix argument, hide previews for all links in the buffer. By default, only links without descriptions are previewed. You can force displaying previews for all supported links (including @@ -11830,14 +11828,14 @@ ** Images and link previews Assure inline display of external link previews in the whole buffer and refresh them. -- {{{kbd(M-x org-link-preview-region)}}} :: +- (~org-link-preview-region~) :: #+findex: org-link-preview-region Create inline previews for external links in the active region, or the buffer. With a prefix argument, also preview links with a text description part. -- {{{kbd(M-x org-link-preview-clear)}}} :: +- (~org-link-preview-clear~) :: #+findex: org-link-preview-clear Clear external link previews in the active region, or the buffer. @@ -11873,7 +11871,7 @@ *** Images [[./img/a.jpg]] #+end_example -When link previews are displayed as images, the image size and +When [[*Images and link previews][link previews]] are displayed as images, the image size and alignment can be further customized. #+vindex: org-image-actual-width