Using Autocomplete in the Rich Text Editor

Summary of Autocomplete

Using Autocomplete for Links

Enter a left-hand square bracket or press Ctrl+Shift+K to call up a list of suggested pages or other locations to link to from your page. You can link to pages, user profiles, images, documents and other file attachments.

To autocomplete a link using '[':

1. Edit the page in the Rich Text Editor.
2. Place your cursor where you want to insert a link and enter a left-hand square bracket like this: [
3. If you want to find a specific page or file, type the first few characters of the page title, user's name, image name or file name.
4. The list of suggestions will appear as a dropdown menu when you pause in your typing.
   • Select the relevant link using the mouse, or the arrow keys plus 'Enter'. The hyperlink will appear on your page, with the name of the destination page or file as the hyperlinked text.
   • If the item you need is not in the list, select 'Search for "xxx"' to continue looking for the page within Confluence, or 'Insert Web Link' to insert a link to an external web page. The link browser will open on the relevant tab. If you need help with the link browser, see the full instructions on adding links. Insert the link via the link browser.
5. Click 'Save' to save the updated page.

To autocomplete a link using Ctrl+Shift+K:

1. Edit the page in the Rich Text Editor.
2. Enter text or just position your cursor:
   • If you want to find a specific page or file, type the first few characters of the page title, user's name, image name or file name.
   • If you want to search for and link more than one word, select the relevant text.
   • If you want to select a link from the pages you have visited recently, position your cursor after a space or at the beginning of a line.
3. Press Ctrl+Shift+K on your keyboard.
   Press Ctrl+Shift+K again to select another word to the left of your current selection. You can press it repeatedly to select multiple words. The repeated selection will stop if there is a change in formatting, such as moving from normal to italic text.
4. The list of suggestions will appear as a dropdown menu.
   • Select the relevant link using the mouse, or the arrow keys plus 'Enter'. The hyperlink will appear on your page, with the name of the destination page or file as the hyperlinked text.
   • If the item you need is not in the list, select 'Search for "xxx"' to continue looking for the page within Confluence, or 'Insert Web Link' to insert a link to an external web page. The link browser will open on the relevant tab. If you need help with the link browser, see the full instructions on adding links. Insert the link via the link browser.
5. Click 'Save' to save the updated page.

Screenshot: Autocomplete for a Link

Using Autocomplete for Images, Videos, Audio Files and Documents

You can use the autocomplete as a fast way of embedding images, videos, audio files and documents into your page. Enter an exclamation mark or press Ctrl+Shift+M to call up a list of suggested images, multimedia files and documents to display on your page. You can use autocomplete to embed the following file types:

• Images – any format that Confluence supports. See Image File Formats.
• Videos, audio files and all multimedia formats that Confluence supports. See Embedding Multimedia Content.
• Office documents supported by the Confluence Office Connector: Word, Excel and PowerPoint.
• PDF ファイル。

Autocomplete works most efficiently for files that are already attached to a Confluence page. See Attaching Files to a Page.

To embed an image, video, audio file or document using '!':

1. If the image, multimedia file or document is not already attached to a Confluence page, attach it in the usual way. See Attaching Files to a Page.
2. Edit the page in the Rich Text Editor.
3. Place your cursor where you want to insert the image, video, audio file or document, and enter an exclamation mark like this: !
4. If you want to find a specific image, file or document, type the first few characters of the image, file or document name.
5. The list of suggestions will appear as a dropdown menu when you pause in your typing.
   • Select the relevant item using the mouse, or the arrow keys plus 'Enter'.
   • If the item you need is not in the list, select one of the following two options:
     • For images and documents, click 'Open Image Browser'. If you need help with the image browser, see the full instructions on inserting images. Insert the image via the image browser.
     • For videos, audio and other multimedia files, click 'Insert Other Media' to open the macro browser. If you need help with the macro browser, see the full instructions on embedding multimedia content. Insert the 'Multimedia' macro to display your multimedia file.
6. The image, multimedia file or document appears on your page.
   • If it is an image, you will see a preview of the image.
   • If it is a video, audio or other multimedia file, you will see the markup for the macro used to display the file. It will look something like this, where the example is an MP4 video file:

     {multimedia:name=My video.mp4}
     

   • If it is a document, you will see the markup for the macro used to display the file. It will look something like this, where the example is a PowerPoint file:

     {viewppt:page=My page of meetings|name=Timeline.ppt}
     

7. Click 'Save' to save the updated page.

To embed an image or document using Ctrl+Shift+M:

1. If the image, multimedia file or document is not already attached to a Confluence page, attach it in the usual way. See Attaching Files to a Page.
2. Go to the page where you want to display the image or document, and edit the page in the Rich Text Editor.
3. Enter text or just position your cursor:
   • If you want to find a specific image or document, type the first few characters of the image or document name.
   • If you want to search for more than one word, select the relevant text.
   • If you want to select an image or document from the current page, position your cursor after a space or at the beginning of a line.
4. Press Ctrl+Shift+M on your keyboard.
5. The list of suggestions will appear as a dropdown menu.
   • Select the relevant item using the mouse, or the arrow keys plus 'Enter'.
   • If the item you need is not in the list, select one of the following two options:
     • For images and documents, click 'Open Image Browser'. If you need help with the image browser, see the full instructions on inserting images. Insert the image via the image browser.
     • For videos, audio and other multimedia files, click 'Insert Other Media' to open the macro browser. If you need help with the macro browser, see the full instructions on embedding multimedia content. Insert the 'Multimedia' macro to display your multimedia file.
6. The image, multimedia file or document appears on your page.
   • If it is an image, you will see a preview of the image.
   • If it is a video, audio or other multimedia file, you will see the markup for the macro used to display the file. It will look something like this, where the example is an MP4 video file:

     {multimedia:name=My video.mp4}
     

   • If it is a document, you will see the markup for the macro used to display the file. It will look something like this, where the example is a PowerPoint file:

     {viewppt:page=My page of meetings|name=Timeline.ppt}
     

7. Click 'Save' to save the updated page.

Screenshot: Autocomplete for an Image or Document

Using Autocomplete for Macros

Enter a left-hand brace to call up a list of suggested macros to add to your page.

Autocomplete provides access to all available macros in your Confluence site, including any user macros that your administrator has added and made visible to all.

マクロの名前を知っている必要があります。マクロのオートコンプリートは、マクロの名前とのみ一致し、説明とは一致しません。

「{」を使用してマクロのオートコンプリートを実行する手順は次のとおりです。

1. Edit the page in the Rich Text Editor.
2. Place your cursor where you want to insert a macro and enter a left-hand brace like this: {
3. If you want to find a specific macro, type the first few characters of the macro name.
4. The list of suggestions will appear as a dropdown menu when you pause in your typing.
   • Select the relevant link using the mouse, or the arrow keys plus 'Enter'. The Macro Browser will appear on your page, with its preview pane on the left and parameter pane on the right. Configure the macro as described in Working with the Macro Browser and click 'Insert' to add the macro to the page.
   • If the macro you need is not in the list, select 'Open Macro Browser' to continue looking for the macro in the Macro Browser. If you need help with the macro browser, see the full instructions on Working with the Macro Browser. Insert the macro via the macro browser.
5. Click 'Save' to save the updated page.

Screenshot: Autocomplete for a Macro

Cancelling Autocomplete

オートコンプリートは、トリガーとなる文字を押すと自動で開始されます。オートコンプリート メニューを終了したり、開始されたオートコンプリートを中止したい場合があります。

開始されたオートコンプリートを停止するにはいくつかの方法があります。

• キーボードのエスケープキー「Esc」を押す。
• エディターパネル内の適当な場所をクリックする。
• 矢印キーを押して、オートコンプリート領域から移動する。
• For the link autocomplete only: Enter a right-hand square bracket, like this: ]

Enabling and Disabling Autocomplete

「[」や「!」文字を使用してオートコンプリートのトリガーをオフにできます。 以下のトリガーとなる文字のいずれかを押すと、オートコンプリートが自動で開始されるのを抑止します。再度オンに戻すことも可能です。

メモ:

• この設定は、オートコンプリートのキーボードショートカットには影響しません (Ctrl+Shift+K および Ctrl+Shift+M)。トリガーとなる文字が無効化された場合でも、キーボートショートカットを使用してオートコンプリートを実行できます。
• この設定は、ユーザー自身にのみ影響を与えます。Confluence を使用している他のユーザーも、それぞれ自分自身のユーザー プロファイルの設定を有効または無効にすることができます。
• オートコンプリートは既定では有効になっています。

オートコンプリートのトリガーとなる文字を有効または無効にする手順は、次のとおりです。

1. Go to the 'Settings' view for your user profile. To do this:

   • Log in to Confluence, if you have not already done so.
   • Go to your name (the 'user' menu) at the top of the page.
   • [設定] を選択します。
2. Choose 'Your Settings' > 'Editor' in the left-hand panel.
3. Click the 'Edit' button.
4. 次のいずれかを実行します。
   • Disable autocompletion by checking the 'Disable Autocomplete' box.
   • Enable autocompletion by clearing the 'Disable Autocomplete' box.
5. Click the 'Submit' button.

Screenshot: User Settings for the Editor

関連トピック

Adding and Removing Links in the Rich Text Editor
Inserting Images in the Rich Text Editor
Rich Text Editor Overview
User Profile Overview

Take me back to the Confluence User's Guide.