Create a Markdown Manual

Markdown (.md) is a lightweight format for writing and structuring content using simple, readable syntax. In ClickHelp, you can export your documentation to Markdown to reuse it in other systems, store it in version control, or integrate it into development workflows.

This article describes how to export an entire project or publication in Markdown format. If you only need a single topic in .md, see the article Retrieving Topics as Markdown.

Exporting a project

To export a project to Markdown:

  1. Hover over the project name and click Publish. How to publish a project
  2. Select Markdown Files Archive as the output type. Markdown files archive (zipped .md and images)
  3. Configure the settings as needed and click Next.
  4. Once publishing is complete, click Next again.
  5. Set the name of the .zip archive, and choose where to save it. Click Next. Setting file name and location
  6. Complete the wizard. On the final screen, download the exported file if needed. Download the exported file

You can also access the exported file later in Storage, in the location selected in step 5.

Exporting a publication

To export a publication to Markdown:

  1. Hover over the publication name and click Export. How to export a publication at ClickHelp
  2. Select Markdown, set the name of the exported .zip archive, and specify where to save it. Click Next. Publishing wizard - selecting Markdown format, the file's name and destination
  3. After export is complete, click Next again.
  4. On the final screen, download the exported file if needed. Last screen of the Publishing wizard

You can also find the file later in the Storage, in the destination you've selected in step 2.