- 0 minutes to read

Add or manage Article

Empower your team with instant access to knowledge and expertise by creating and managing Knowledge Base Articles in Nodinite. This guide shows you how to capture operator instructions, technical documentation, and best practices using a powerful WYSIWYG editor—delivering knowledge exactly where your team needs it.

✅ Create rich, formatted articles with WYSIWYG or Markdown editor
✅ Embed images, videos, diagrams, and HTML for maximum clarity
✅ Associate articles with Resources, Applications, and Categories
✅ Organize with Tags for easy search and discovery
✅ Deliver knowledge directly in Monitor Views and Integration Landscape

This guide teaches how to add or manage a Knowledge Base Article.

Tutorial overview

Use the following table as your to-do list for managing Knowledge Base Articles. Stay organized and ensure every article is complete, well-organized, and accessible for maximum business value.

# Topic
1. Add or Manage Article
2. Name and Describe the Article
3. Create Content with WYSIWYG Editor
4. Organize with Tags
5. Associate with Resources, Applications, and Categories
6. Enrich with Custom Metadata

Step 1: Add or Manage Article

Click the Add/New button to create a new Knowledge Base Article from the Articles Overview page in the Repository menu.
Add New Article Button
Click the 'Add Article' button to create a new Knowledge Base Article.

Alternatively, you can add an article directly from a Resource, Application, or Category by clicking the Actions button and selecting Articles.

Step 2: Name and Describe the Article

Give your Knowledge Base Article a clear, descriptive name that helps users quickly identify its purpose. The name appears in article lists, search results, and Monitor Views.
Name and Description
Enter the article name and optional description.

Mandatory fields

  • Name: Every Knowledge Base Article must have a unique, descriptive name. You can safely change this name at any time.

Optional fields

  • Description – Provide a brief summary of the article's content and purpose. This appears in article lists and helps users decide if the article is relevant to their needs.

Step 3: Create Content with WYSIWYG Editor

Use the powerful WYSIWYG (What You See Is What You Get) editor to create rich, formatted content without writing HTML code. The editor supports a wide range of formatting options, making it easy to create professional, user-friendly documentation.
WYSIWYG Editor
The WYSIWYG editor with formatting toolbar and content area.

Editor capabilities

  • Rich text formatting – Bold, italic, underline, headers, lists, and more
  • Embed images – Paste from clipboard, upload from file, or drag and drop
  • Embed videos – Include instructional videos for step-by-step guidance
  • Add hyperlinks – Link to other articles, external documentation, or resources
  • Create tables – Organize information in structured tables
  • HTML view – Switch to code view for advanced formatting and styling
  • Mermaid diagrams – Embed flow charts, sequence diagrams, and more
  • Full-screen mode – Maximize your editing space
  • Keyboard shortcuts – Speed up editing with shortcuts (press F1 for help)

Tip

Use the full-screen mode for distraction-free writing. Click the expand icon in the toolbar or press F11.

Content best practices

  • Start with a clear heading – Use H1 or H2 headings to organize your content
  • Use bullet points – Break down complex procedures into easy-to-follow steps
  • Add visuals – Screenshots and diagrams make instructions clearer
  • Include links – Reference related articles, systems, or external documentation
  • Keep it concise – Focus on what users need to know, not everything you know

Step 4: Organize with Tags

Nodinite Tags help users find related articles quickly. Tags are free-form text values you create to categorize and organize your knowledge base. Unlike Categories and Applications, which are predefined by your monitoring setup, Tags give you complete flexibility.
Tags
Add tags to organize and categorize your article.

How to add tags

  1. Start typing in the Tags field
  2. Select an existing tag from the dropdown or create a new one
  3. New tags are indicated with a ***** (asterisk)
  4. Add as many tags as needed to help users find your article

Tag examples

  • troubleshooting – For articles about resolving common issues
  • getting-started – For onboarding documentation
  • sap – For articles related to SAP integrations
  • critical – For high-priority operational procedures
  • monthly-maintenance – For recurring maintenance tasks

Tip

Establish a tagging strategy across your organization. Consistent tag naming makes your knowledge base more searchable and valuable.

Step 5: Associate with Resources, Applications, and Categories

Control where your article appears by associating it with specific Resources, Applications, or Categories. This ensures users see relevant articles exactly when and where they need them.
Associate Article
Choose how to associate your article with monitoring entities.

Association options

Share with Applications
Associate the article with one or more Applications. The article becomes visible for all Resources belonging to those Applications.

  • Use when: The article applies to an entire application or business domain
  • Example: "SAP Integration Best Practices" shared with the SAP Application

Share with Categories
Associate the article with one or more Categories. The article becomes visible for all Resources in those Categories.

  • Use when: The article applies to a type of resource or technology
  • Example: "SQL Server Troubleshooting" shared with Database Category

Associate with selected Resources
Associate the article with specific Resources. The article appears only for those selected Resources.

  • Use when: The article is specific to particular resources
  • Example: "Restart Procedure for CustomerOrderService" for that specific service

Tip

You can combine association types. An article can be associated with Applications, Categories, AND specific Resources simultaneously.

Viewing associations

From the Relations tab, you can see all Resources, Applications, and Categories currently associated with your article. You can add or remove associations at any time.
Article Relations
View and manage all associations for your article.

Step 6: Enrich with Custom Metadata

As part of the Repository Model, you can add Custom Metadata to your Knowledge Base Articles for enhanced governance, searchability, and business context.
Custom Metadata
Add Custom Metadata to capture business-critical information.

Custom Metadata enables you to:

  • Capture ownership – Assign article owners or responsible teams
  • Track approval status – Mark articles as draft, approved, or under review
  • Document compliance – Add audit trail information or regulatory references
  • Set expiration dates – Flag articles for periodic review
  • Link to tickets – Reference change requests or incidents

Tip

Use Custom Metadata instead of Custom Fields for better flexibility and advanced features.


Where Articles Appear

Once created and associated, your Knowledge Base Articles become instantly accessible throughout Nodinite:

  • Monitor Views – Operators see article counts and can access them directly from Resources
  • Integration Landscape – View articles associated with Integrations, Systems, and Services
  • Articles Overview – Central repository for all knowledge base content
  • Search Results – Articles appear in global search when users search for topics or tags

The number of associated articles is visible in Monitor Views, making it easy to see which Resources have documentation available.


Frequently Asked Questions

Can I use Markdown instead of the WYSIWYG editor?

Yes! Nodinite supports both WYSIWYG (HTML) and Markdown. Switch to code view to write Markdown or HTML directly. The editor automatically renders your Markdown when you switch back to visual mode.

How do I embed a Mermaid diagram?

In the code view, use Mermaid syntax within a <div class="mermaid"> block:

<div class="mermaid">
graph LR
    A[Start] --> B[Process]
    B --> C[End]
</div>

Can I delete an article?

Yes. From the Articles Overview, use the Actions menu to delete an article. Deleted articles can be restored later by enabling "Show deleted Articles" and selecting Restore from the Actions menu.

How do I export articles?

Use the Export function from the Actions menu to export articles individually or in bulk. This opens the Nodinite Import/Export wizard, allowing you to back up articles or move them between environments.

Can I copy content from Word or other editors?

Yes! Simply copy formatted text from Word, Confluence, or other editors and paste it into the WYSIWYG editor. Nodinite preserves most formatting, though you may need to adjust styles for consistency.


Next Step

Articles Overview
Manage Tags
Repository Model

Custom Metadata
Custom Fields
Applications
Categories
Resources
Monitor Views
Integrations