Write an article

Use these steps to create an article in a knowledge base and write its content in the visual or Markdown editor.

Before you begin

• You need the Editor role or higher on the knowledge base. See How content is organized.
• The knowledge base must already exist. See Create a knowledge base.

Create the article

1. Select Authoring in the top navigation.
2. In the Navigation panel on the left, choose the knowledge base from the Knowledge base list.
3. In the editor, select the New document icon.
4. Enter a Title.
5. Enter a Slug (filename), a short unique name for the article’s web address, such as getting-started. Use lowercase letters, numbers and hyphens.
6. Select Create article.

Write the content

1. Choose how you want to write with the Editor mode switch:
   • Visual shows the article as it will look.
   • Markdown shows the underlying text.
2. Type your content. Use the toolbar to format it, for example bold, italic, headings, and bulleted and numbered lists.
3. To go further, see:
   • Add an image
   • Add a note or alert
   • Add tabbed content
   • Insert shared content into an article
   • Import an article from a Markdown file

Changes you have not saved are marked Unsaved changes.

Add the article to the navigation

An article is only listed on the site if it is in the navigation.

1. In the Navigation panel, select Add to navigation.
2. Choose what to add:
   • Current article adds the article you are editing. Save it first.
   • Choose existing articles lets you search for articles and add several at once.
   • New group adds a heading that holds other articles.
   • External link adds a link to another website, with a label and a web address.
3. Select Save navigation. The panel shows Nav saved when it is done.

For groups, links, dividers, renaming and ordering, see Organize the navigation.

Next

• Review an article
• Save a draft
• Save an article for publishing