editors.md

title	description	published	date	tags	editor	dateCreated
Editors	Using the various editors of Wiki.js	true	2021-04-03 00:52:28 UTC	editors	markdown	2019-05-22 03:11:37 UTC

When creating a page, you can use the editor of your choice. Some users prefer to write content in Markdown while others might prefer a more visual editor.

List of Editors

• API Docs *REST / GraphQL *(coming soon)**
• Blog *Timeline of Posts *(coming soon)**
• Code Raw HTML
• Markdown Plain Text Formatting
• Tabular *Excel-like *(coming soon)**
• Visual Editor Rich-Text WYSIWYG {.links-list}

Change Editor

This feature is available from version 2.5.201 and up. {.is-info}

You can change the editor used for any page using the Convert action. This will attempt to convert the content to be used by the newly selected editor. For example, a page previously created with the Markdown editor can be converted to HTML to be used with the Visual Editor.

From the Page Actions menus (located at the top-right corner and bottom-right corner), select Convert. The following dialog is shown:

{.radius-5 .decor-shadow}

Select the editor you want to use going forward and click Convert.

⚠️ Important

Because of differences between editor / format capabilities, some formatting or non-rendered content may be lost after the conversion.

A snapshot of the page is automatically taken before the conversion and you can revert or refer to this version at any time afterwards from the page history.

Examples

∗ When going from Markdown to HTML, draw.io diagrams will be kept as their final rendered image. You will no longer be able to edit the diagram. ∗ When going from Markdown to HTML, tabsets will be reverted to standard headers and paragraphs (as seen in the markdown editor). ∗ When going from HTML to Markdown, custom CSS classes and HTML elements that don't exist in the Markdown language will not be preserved. {.is-warning}

As a reference, the following format conversions occur based on the source / target editor selected:

Source	Target	Format Conversion
Markdown	Visual Editor	Markdown -> HTML
Markdown	Raw HTML	Markdown -> HTML
Visual Editor	Markdown	HTML -> Markdown
Visual Editor	Raw HTML	no format conversion needed{.caption}
Raw HTML	Markdown	HTML -> Markdown
Raw HTML	Visual Editor	no format conversion needed{.caption}