Creating Knowledge Base Articles¶
The Knowledge Base app contains everything you need to create a repository of articles. You can create articles by authoring them in the app’s WYSIWYG editor or by importing them from Markdown files (
.md) in a ZIP archive. The sections below cover both ways of creating articles.
To access Knowledge Base in Site Administration, a Role must have the permission Knowledge Base > Access in Site Administration. To add or act on articles, folders, or suggestions, the Site administrator must grant the appropriate permissions using the Permissions window in Knowledge Base.
To navigate to the Knowledge Base app, click the Menu icon () and navigate to Content and Data → Knowledge Base. The Knowledge Base app has three tabs:
Articles: Create and manage articles and folders.
Templates: Create and manage templates.
Suggestions: Manage user-submitted feedback for articles.
Importing Knowledge Base Articles¶
You can also create new Knowledge Base articles by importing them from a ZIP archive that contains articles in the Markdown format (
.md). For example, you could write articles in your favorite Markdown editor, package them in a ZIP file, and then import that ZIP file to create those articles in the Knowledge Base. The Knowledge Base can also prioritize articles by their filenames’ numerical prefixes. For example, the Knowledge Base would list
02-article.markdown in ascending order by their numerical prefix (
02). For more information on article priority, see Managing Knowledge Base Articles for detailed information on the Knowledge Base importer:
To import articles, your Role must have the permission Knowledge Base → Resource Permissions: Import Articles.
To import articles into the Knowledge Base,
In the Articles tab, click the Add icon () and click Import.
Click Choose File and locate the ZIP file to import.
If you want to use the files’ numerical prefixes to prioritize the imported articles in the Knowledge Base, select Apply numerical prefixes of article files as priorities.
Click Save when you’re finished.
Like all articles, imported articles are automatically converted to HTML for the Knowledge Base and listed in a table with the rest of the articles in the Articles tab.