Implementation Guide Editor

The Implementation Guide Editor enables you to make implementation guides (IG) using the resources available in Simplifier. You can include your own project’s Resources or those from others in your IG. With the help of this Markdown based editor you can easily construct an organized and practical IG that is both easy to read and navigate. This IG editor is available in all Simplifier account plans. Visit for more details.

This page will elaborate further on getting started and how you can use the IG editor.

Create your first IG

You can access the IG editor via the Guides tab in your project. In earlier versions of Simplifier, Implementation Guides were created from a user’s portal, but this is no longer possible as Implementation Guides are linked to a specific project. Use the Create button to create a new Implementation Guide and provide a title for the IG.


Click on Browse or the Implementation Guide itself for a preview of the guide. Click on the Edit button to open the Implementation Guide in the IG editor.

IG Editor Settings

The IG editor opens on the page of the root element. The IG Editor consist of three sections. On the left is the IG’s tree table which is used to define the outline of your IG and navigate between the pages of the IG. The middle section is the actual editor. This is where you will add and edit content. The right section is where you will find a rendering of the selected page.

By way of dragging the section bars you can adjust the size of each section to customize your view.

To adjust the settings of your IG click on the Settings icon (the rightmost icon representing a gear wheel). This brings you to a section that allows you to adjust the title and privacy on the Settings tab, or select an IG rendering format and Stylesheet file on the Style tab.


Formatting style

An IG can be rendered in one of three formats: a Tree table, Two Level Menu or HL7 Ballot format.

A Tree table rendering will display your IG with the elements in a format similar to the tree table with the elements and their hierarchy along the left side of the page.


A Two Level Menu rendering will display your IG with the elements in tabs along the top of the page.


A HL7 Ballot rendering will display your IG with the elements in tabs along the top of the page similar to the Two Level Menu rendering, but in the style of a HL7 Ballot IG.

To add a new menu item to your Implementation Guide, use the + icons in the upper left corner of the IG editor. Click on either the add Child guide item icon to add a sub menu or on the add Sibling guide item icon to add a menu at the same level as the one you have selected. You can rename the items by either double clicking them or use the pencil icon in the icon bar. To delete a menu item, select it and click on the recycle bin icon.


For our Enterprise Licenses the feature “Custom Layout” is available. Here you can create your own custom master template (HTML) and choose your own layout (CSS). When you click on the icon on the left of the Settings icon in the IG-editor, the CSS-editor will be opened.


With this editor you can edit your Style Sheet to make overall changes in the overall look and feel of your IG. For example, you may change the color of the navigation bar to blue or add your own logo to it. It is also possible to reset your changes by going back to the original CSS or download the original CSS as a seperate file, so you can compare the differences with your own code.

Here below are a couple of examples that you can use to configure the lay-out of your IG:

/* Change menu bar font color (title, menu & submenu) */
#ig-viewer .ig-view-content #ig-view-twolevelmenu .header .navbar a {
    color: white;
/* Change menu bar background color (only main menu) */
#ig-viewer .ig-view-content #ig-view-twolevelmenu .header .navbar {
      background-color: red;
/* Change menu bar font color (only main menu) */
#ig-viewer .ig-view-content #ig-view-twolevelmenu .header .navbar-nav > li > a {
    color: green;
/* Change menu bar hoover item background color and font color (only main menu) */
#ig-viewer .ig-view-content #ig-view-twolevelmenu .header .navbar-nav > li > a:hover {
    background-color: black;
    color: red;
/* Change menu bar background color (only submenu) */
#ig-viewer .ig-view-content #ig-view-twolevelmenu .header .navbar .dropdown-menu {
    background-color: yellow;
/* Change menu bar font color (only submenu) */
#ig-viewer .ig-view-content #ig-view-twolevelmenu .header .navbar .dropdown-menu a {
  color: black;
/* Set logo by using an external image */
#ig-viewer .ig-view-content #ig-view-twolevelmenu .header a.navbar-brand {
    color: transparent;
    background: url('http://image.png');
    background-position: left center;
    background-size: contain;
    background-repeat: no-repeat;
/* Set the font color of your headers */
h1, h2, h3, h4{
    color: #DF0101;
/* Set a background color to level 2 headers */
    background-color: #eeecec;
    padding: 0.5em;


In the middle section is a Markdown based editor used to compose your IG content. Markdown is a text-to-HTML conversion tool. It allows you to write using an easy-to-read, easy-to-write plain text format. The following link provides an overview of the Markdown features which can be used in this editor:

A short summary of frequently used features are as follows:

  • Header size edits using #Header size 1 to ######Header size 6

  • Adding Emphasis, also know as italics, with *asterisks* or _underscores_

  • Adding Strong emphasis, also known as bold, with **asterisks** or __underscores__

  • Adding Combined emphasis with **asterisks` and _underscores_**

  • Strikethrough uses two tildes. ~~Scratch this.~~

The IG editor has features which allow you to include Simplifier content in your IG. These features work by using the statements written below in the editor. After adding these statements in the editor refresh the page, by pressing Crtl + Enter or clicking the Refresh button, to make them visible in the preview section.

  • {{tree:ProjectName/ResourceName}} - renders a tree structure as seen in the resource overview tab

  • {{table:ProjectName/ResourceName}} - renders a table as seen in the resource table tab

  • {{structure:ProjectName/ResourceName}} - renders the resource in a newly defined tree (unfinished)

  • {{link:ProjectName/ResourceName}} - provides a link to the specific resource page on Simplifier

  • {{namingsystems:ProjectName}} - lists all namespaces of a project in a table

The statement is made up of 2 parts: the kind of function and the location of the content in Simplifier. The location is based on the name of the project and the name of the resource. They can be found in the Simplifier URL after the hostname ( For example, if you want to include a profile on an Organization, as described at a correct statement would be {{tree:DAF/daf-organization}}.

The following statements add an index within the IG.

  • {{index:root}} - gives an index of the entire IG

  • {{index:current}} - gives an index of the current selected element

IG Storage

Since release 16.5 IG’s are stored as separate mark down files in your project. This means that you can access them as separate resources, add issues to them and check version history. In addition, your IG’s will be downloaded in a ZIP file together with the other files of your project.

To illustrate how this works, see the screen picture of an example IG containing two chapters called ‘First part’ and ‘Second part’. The First part also contains a child called ‘Child of first part’. The different parts of the IG are now accessible from the Resources tab in your project as well as from the search engine. To search for IG parts, just check the Texts box.

_images/ig-tree-example.png _images/new-test-resources.png

To Save your IG as a Resource, click on the Save button in the left pane of the IG-editor. Note that it is the tree structure that is saved. Textual changes are save automatically.


Export your IG

To use your IG outside of Simplifier, click on the Export button next to your IG in the Guides section of your project.


Convert ImplementationGuide resource to a Simplifier webbased IG

An ImplementationGuide resource can be converted to a Simplifier webbased IG. This comes in handy if you for example accidently deleted your IG or if you want to duplicate your IG in another project.

  • Make sure that the project contains the ImplementationGuide resource and all the belonging content (.md pages, images, etc.)

  • Locate the an ImplementationGuide resource.

  • Click on Update followed by Edit: Create IG and start updating in IG Editor. This will convert the ImplementationGuide resource to a Simplifier IG.

  • Follow the configuration steps and locate the IG in the Guides tab.

Note: If you want to export and import a project through a .zip you have to make sure that the folder structure is the same as in the project, to make sure links between IG resources are still in tact. Zipping a containing folder will include the folder in the zip-file. To make sure no extra layer of folders is added, directly zip the resources within a folder instead.

Manage your IG using GitHub

The GitHub webhook allows managing your Implementation Guide, without using the editor itself. You can find more information on how to set this up in the GitHub integration documentation.