Text Editor Overview
  • Updated on 14 Nov 2019
  • 2 minutes to read
  • Contributors
  • Print
  • Share
  • Dark
    Light

Text Editor Overview

  • Print
  • Share
  • Dark
    Light

Document360 has two text editors for creating and writing articles:

  1. The Markdown editor
  2. The WYSIWYG (What You See is What You Get) editor

The Markdown editor lets writers use Markdown syntax and HTML to customize articles. The WYSIWYG editor uses Rich Text formatting and includes an extensive formatting toolbar, however you cannot use custom code in articles.

Default Setting
Unless otherwise configured, all projects and articles will use The Markdown editor by default

When to use Markdown vs. WYSIWYG

The Markdown editor provides a lot of flexibility for article 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] (http://linktoyourimage/image.png){height="" width=""}

You could then change the height and width of the image by providing the desired values (for example: height="600px" width="400px"). You could also apply other styles to the image by adding additional HTML and Markdown.

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 mostly text-based, or if you need to insert code blocks or other custom HTML tags, use the Markdown Editor. If your article includes images, videos, tables, or other media, use the WYSIWYG editor for easier formatting.

Markdown WYSIWYG
Flexibility X
Customization X
Code blocks X
Text-based Docs X
Media-heavy docs X
Easier formatting X
Straight-forward X

Markdown Text Editor

The Markdown editor has a split-screen, as well as other features to help you manage your article as you write it.

  1. The left side of the screen is where you type and apply Markdown syntax.
  2. The preview screen on the right side allows you to view how your article will look before publishing it.
  3. Scroll On indicates the two sections of the text editor will scroll simultaneously as you scroll on one screen. Click Scroll On to disable the auto-scroll.
  4. Click Public Preview to see your article as it will appear on your public site.

Parts of text editor(1)

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 than the Markdown editor in that what you see when you draft an article will look exactly the same when the article is published.
WYSIWYG Text Editor

Switching between Markdown and WYSIWYG

The 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 it at a project or article level.

To switch editors In an individual article:

  1. In the article, open the Article Settings menu in the top right of the Editor.
  2. Click Choose your choice of editor.
  3. Select WYSIWYG.

To make the WYSIWYG editor the project’s default editor:

  1. In Settings, click General.
  2. In Choose your choice of Editor, select WYSIWYG
If you change to the WYSIWYG editor to be your default project editor, you can’t change individual articles to Markdown.

WYSIWYG vs Markdown(1)

Was this article helpful?