Document360 has two text editors for creating and writing articles:
1. Markdown editor
2. WYSIWYG (What You See is What You Get) editor
Markdown editor lets writers use Markdown syntax and HTML to customize articles. WYSIWYG editor uses Rich Text formatting and includes an extensive formatting toolbar; however, you cannot use custom code in articles.
When to use Markdown vs. WYSIWYG
Markdown editor provides a lot of flexibility for article creation and customization. However, the flexibility comes with using markdown syntax or HTML.
For example, you can insert images into your article using the toolbar, which injects the following Markdown:
![Image Alt Text] (Image URL){height="" width=""}
You can then change the height and width of the image by adding the desired values (for example: height="600px" width="400px"). You can also apply other styles to the image by adding additional HTML and Markdown syntax.
In WYSIWYG mode, you would use the formatting toolbar to insert an image, then click on the image to view options to change the image size and styles.
If your article is primarily text-based, or if you need to insert code blocks or other custom HTML tags, use the Markdown Editor. Use the WYSIWYG editor for easier formatting if your article includes images, videos, tables, or other media.
| Markdown | WYSIWYG | |
|---|---|---|
| Customization | X | |
| Code blocks | X | |
| Text-based docs | X | |
| Media-heavy docs | X | |
| Easier formatting | X |
Markdown Editor
The Markdown editor has a split-screen workspace and other features to help you manage an article as you write it.
-
The left side of the screen is where you type and apply Markdown syntax
-
The preview screen on the right side allows you to view how your article will look before publishing it
-
Scroll on indicates the two sections of the text editor scroll simultaneously as you scroll on one screen. Click Scroll on to disable the auto-scroll
-
Click View preview to see your article as it will appear on your Knowledge base site
-
Once you publish your article, you can find a Copy link icon next to View in knowledge base icon. You can find this copy link icon on the category page, article, and Index page.
As you type the content on the left side, you can view the rendered output on the right side. Use the arrows on the divider to collapse either portion of the editor.
WYSIWYG Text Editor
The WYSIWYG editor is different from the Markdown editor in that what you see when you draft an article will look the same when published.
Switching between Markdown and WYSIWYG
Markdown editor is the default editor for all new projects and articles in Document360. If you want to use the WYSIWYG editor, you can switch to it at a project or article level.
To switch editors in an individual Article/category page:
- In the article/category page, click the Article Settings menu icon on the top right
- Click Editor and select WYSIWYG(HTML)
- Click Yes in the Change confirmation prompt window and then click Save on the bottom right
To make the WYSIWYG editor the default editor:
- From the knowledge base portal, go to Settings→ Knowledge base portal → General → Documentation
- In Editor section, select WYSIWYG(HTML) and click Save