Adding images to articles

Plans supporting the addition of images to articles

Adding images to your articles enhances comprehension and engagement. Visual aids clarify complex procedures and illustrate desired outcomes more effectively than text alone. Images simplify instructions, making them easier to follow and understand. They enhance the user experience and contribute to the overall effectiveness of the documentation.

There are several methods to insert images into your articles using the Markdown editor or the Advanced WYSIWYG editor. Each method offers its own set of advantages and allows for customization to suit your preferences.

Inserting an image in the Markdown editor

You can insert images in your documentation with the Markdown editor in four ways.

1. Insert image from Upload/URL

2. Insert image from file picker

3. Insert image using Insert file

4. Insert image by drag and drop

1. Insert image from Upload/URL

Using upload

1. Navigate to the desired article in the Markdown editor.

2. Click the Insert image () icon and select From Upload/URL.

3. In the File tab, click the Choose File button.

4. Select the image file you want from your local storage and click Open.

5. In the Description field, type in a description for the image.

6. Click OK.

   The image will be inserted into the article where the cursor is placed.

NOTE

The height and width of the image will not be set by default {height="" width=""}.

7. If required, you can specify the pixel (px) dimensions for displaying your image in the documentation.

For example, {height="720" width="1280"}.

You can see the size of the image in the documentation in the Preview window.

From URL

1. Navigate to the desired article in the Markdown editor.

2. Click the Insert image () icon and select From Upload/URL.

3. In the URL tab, enter the desired Image URL.

4. In the Description field, type in a description for the image.

5. Click OK.
   The image will be inserted into the article where the cursor is placed.

NOTE

The height and width of the image will not be set by default {height="" width=""}.

5. If required, you can specify the pixel (px) dimensions for displaying your image in the documentation.

For example, {height="720" width="1280"}.

You can see the size of the image in the documentation in the Preview window.

NOTE

We recommend adding images to the Document360 Drive and then inserting them into articles. When you upload using the image URL, If the image is removed or renamed in the future, it will appear broken in the Knowledge base sites.

2. Insert the image from the file picker

1. Navigate to the desired article in the Markdown editor.

2. Click the Insert image () icon and select From file picker.

   The Drive window will appear with only image format files.

NOTE

You can insert any number of images in one go. The multiple image selection is available only on Markdown and Advanced WYSIWYG editors.

4. Navigate to the desired folder where the image you wish to upload is available.

5. Select the desired image(s) and click Insert.
   The image will be inserted into the article where the cursor is placed.

6. If required, you can specify the pixel (px) dimensions for displaying your image in the documentation.

For example, {height="720" width="1280"}.

You can see the size of the image in the documentation in the Preview window.

3. Insert an image using the ‘Insert file’

1. Navigate to the desired article in the Markdown editor.

2. Click the Insert file ().

   The Drive panel will appear.

3. Navigate to the desired folder where the image you wish to upload is available.

4. Select the image and click Insert.
   The image will be inserted into the article where the cursor is placed.

NOTE

The height and width of the image will not be set by default {height="" width=""}.

5. If required, you can specify the pixel (px) dimensions for displaying your image in the documentation.

For example, {height="720" width="1280"}.

You can see the size of the image in the documentation in the Preview window.

4. Insert an image using drag and drop

You can add an image to the editor by dragging it from your local system to your editor.

The images you insert in an article through drag and drop will be saved automatically in the Document360 Drive. Any changes made to your local file will not affect the inserted image.

Inserting an image: Advanced WYSIWYG editor

You can insert images in your documentation with the Advanced WYSIWYG editor in the following methods.

1. Using the ‘Insert’ menu

2. Using copy and paste or drag and drop

1. Using the ‘Insert’ menu

1. Navigate to the desired article in the Advanced WYSIWYG editor.

2. You can use the slash menu /image to insert the Image

   Alternatively, click the Insert menu () and select Image.

3. Select Image, and a panel will appear with following options:

   • Upload from my device: Click to upload or drag and drop the image file from your device's local storage.

   • Choose from Drive: Opens the file picker, and you can choose any image format available in your Document360 Drive.

   • External URL: Paste the URL of the image in the field.

4. Click Insert, and the image is added to the article.

2. Using copy and paste or drag and drop

Alternatively, you can perform a copy/paste operation for the image or click, drag, and drop an image from your device's local storage inside the article.

The images you insert in an article through drag and drop will be saved automatically in the Document360 Drive. Any changes made to your local file will not affect the inserted image.

NOTE

You can format images in the Advanced WYSIWYG editor. For more information, read the article on Image formatting in the advanced WYSIWYG editor.

FAQs