Edit a markdown component

After you import a markdown file as a component, you can edit the content even though it's stored as a Binary file. However, you have less tools to use when editing because a markdown file is also more simple than an XML document.

Be aware that you don't have the tools necessary for XML editing, such as the:

  • Left side panel with the XML structure
  • Right side panel for XML attributes and validation
  • Breadcrumb at the bottom of the screen for managing XML elements

This is by design because a markdown component doesn't use XML code.

To edit a markdown component:

  1. To create a section:
    1. To start a section with Header 1, put your cursor where you want the section to start. In the toolbar, click .
    2. To start a section with Header 2, put your cursor where you want the section to start. In the toolbar, click .
    3. To start a section with Header 3, put your cursor where you want the section to start. In the toolbar, click .
    4. To start a new section with a horizontal line above, put your cursor where you want the section to start. In the toolbar, click .
  2. To format text:
    1. To format text as bold, select the text, and in the toolbar click .
    2. To format text as italic, select the text, and in the toolbar click .
    3. To format text with a line striking it out, select the text, and in the toolbar click .
    4. To format text as a code block, select the text, and in the toolbar click .
    5. To format the text as a block quote, select the text, and in the toolbar click .
  3. To add a list:
    1. To create a numbered list, put your cursor where you want the list to start. In the toolbar, click .
    2. To create a list with bullets, put your cursor where you want the list to start. In the toolbar, click .
    3. To create a task list, put your cursor where you want the list to start. In the toolbar, click .
  4. To add a table:
    1. To insert a table, put your cursor where you want it. In the toolbar, click .
    2. Use the columns and rows to add your data.
  5. To add a reference to other content:
    1. Put your cursor where you want the reference.
    2. In the toolbar, click .
    3. On the Insert link screen, enter or paste in the URL to the web page you want to add a link to. To browse and find a resource inside Inspire, click the folder icon.
    4. Optionally, on the Insert link screen, in Text, enter text that the user clicks to open the link.
    5. Optionally, on the Insert link screen, in Title, enter text that describes the link.
    6. Click OK.

      Results: You see a link inserted.

  6. To insert an image:
    1. Put your cursor where you want the image to display.
    2. In the toolbar, click .
    3. On the Insert image screen, enter or paste in the URL to the image you want to insert. To browse and find an image inside Inspire, click the folder icon.
    4. Optionally, on the Insert image screen, in Alternate text, enter text that the user sees if the image doesn't load. This text can also be read by a screen-reader for users with impaired vision.
    5. Optionally, on the Insert image screen, in Title, enter text that describes the link.
    6. Click OK.

      Results: You see a link to the image you inserted.

  7. To report a problem:
    1. In the toolbar, click the more menu and select Report problem.
    2. On the Report a problem screen, enter as much details as you can and then click Report a problem.
  8. To manage your file:
    • To save your changes locally and keep working, click Oxygen_save Save .
    • To save your changes to the database and close the map, click Save and Submit.
    • To save your changes to a new component, click Save as.