- 23 May 2022
- 3 Minutes à lire
- Mis à jour le 23 May 2022
- 3 Minutes à lire
The Markdown Editor uses Markdown formatting, a short-hand syntax that styles text, and then converts that text to HTML, to create documents.
Markdown comes in handy when major text and mild media are involved in the documentation.
Document360 has another editor - The WYSIWYG editor. You can use this when there is major involvement of media in the documentation.
For a list of basic Markdown commands, refer to Markdown basics.
Using Markdown in your knowledge base
- When you create a new project, the Markdown editor is set as the project's default editor.
For more information on text editor options, refer to Text editor overview.
- When using the Markdown editor, you can use Markdown syntax manually while writing, or simply format text using the Markdown toolbar.
For example, you can make a text appear as Bold by writing the respective syntax or use the Bold icon in the Markdown toolbar.
- If you need a quick syntax reference while writing an article, you can view common Markdown commands right in the editor by clicking Shortcut on the bottom left of the screen.
- When you write a syntax, make sure that the syntax reference matches the required character arrangement.
For example, In Bold syntax, no space should be present at the end or beginning of the characters mentioned inside the syntax.
In Headings, a space is required between the respective syntax and characters.
Use the Markdown toolbar to format your docs without writing Markdown manually.
- H2: Refers to Heading 2
- H3: Refers to Heading 3
- H4: Refers to Heading 4
Basic text formatting
- Bold: To Bold the text
- Italic: To Italicize the text
- Strikethrough: To Strikethrough the text
- Blockquote: To offset a quote or paragraph with a line. For example, the below sentence is in Blockquote:
This is an example for Blockquote.
- Unordered list: To make a list denoted with bullet points for each item
- Ordered list: To make a list denoted with numbers for each item
- Line: To insert a line in the article
- Insert Table: To add a table to the article
- Insert image: To insert an image from the URL or the local drive or the Document360 Drive. Read more →
- Insert file: To insert a PDF or word document from the Drive. Read more →
- Insert a link: To add a hyperlink from a provided URL, or a knowledge base article to the selected text. Read more →
- Insert Codeblock: To add a code block to your article. Refer to →
- Insert Video: To embed a video from YouTube, Wistia, or Vimeo
- Info: To insert an editable blue infobox. You can use this to add additional information
- Warning: To insert an editable yellow warning box. You can use this to add important information
- Error: To insert an editable red error box. You can use this to add essential information
- Private notes: To insert an editable purple internal comment box that will only be visible to logged-in team members. Read more →
For example, you can add internal feedback to the respective team members
Find and Replace
- Find and Replace: To search a text within your article, and replace it with another text. You can also use this to find the occurrences of the text content in the article. This is particularly handy in long articles
Insert latex: To add expressions and equations
Click on Insert latex option and a sample latex syntax (
Type in your desired syntax
The syntax must start and end with $
Don't add a space between $ and syntax.
- Click here to view the basic latex commands used in latex syntax
- Content reuse: To reuse the content across the project. Two content reuse options are available:
a. Variable: Only text content can be added inside a variable. Read more →
b. Snippet: You can add images, tables, etc., inside a snippet. Read more →
Markdown editor does not support any third-party spellcheck tool while writing. Please use the WYSIWYG editor to write with third-party spellcheck tools.