---
title: Authoring Tools
slug: books/technical-writing/authoring-tools
createdAt: 2025-04-29T17:04:01.617Z
---

Generally speaking, an authoring tool is a software application or platform that enables technical writers to create, edit, structure and manage content for documentation.

An authoring tool typically supports:

:::DropList
```json
{
  "columns": [
    {
      "id": "1",
      "name": "🧩",
      "items": [
        {
          "id": "HCEYa77V6qTZUYxqlj6Yi",
          "content": "Modular content creation",
          "justAdded": false
        },
        {
          "id": "QZCitTiaNfownaBAuTkdi",
          "content": "Allows writers to organize content into modular or reusable components (topics, chapters).",
          "justAdded": false
        }
      ]
    },
    {
      "id": "2",
      "name": "📑",
      "items": [
        {
          "id": "iUPqpx_L55n2YH5sct3Bh",
          "content": "Multiformat output",
          "justAdded": false
        },
        {
          "id": "v2BJZqZC-iswGB2_Uz6ur",
          "content": "Facilitates publishing content to various formats like HTML, PDF or Word.",
          "justAdded": false
        }
      ]
    },
    {
      "id": "3",
      "name": "🎨",
      "items": [
        {
          "id": "2hUuekmFUMvc8oo6iJS7k",
          "content": "Formatting and styling",
          "justAdded": false
        },
        {
          "id": "BOYKTXsbKxPpCSLiHSzhQ",
          "content": "Provides tools for consistent typography, headings, tables and visual elements.",
          "justAdded": false
        }
      ]
    }
  ]
}
```
:::

Depending on the tool, you could author in:

- **Pure WYSIWYG** ("what you see is what you get")
  Tools like Microsoft Word or Google Docs provide a visual interface for formatting text, inserting images and creating tables, without needing technical skills.
  With pure WYSIWYG tools, users don't have access to the underlying structure of the documents.
- **Wiki-style**
  Wiki platforms such as Confluence allow collaborative, web-based documentation creation with real-time updates and internal linking.&#x20;
  Most wikis give users access to edit the underlying code (HTML, Markdown), but not always out-of-the-box.
- **HTML-based**
  Tools like MadCap Flare or Adobe RoboHelp support complex layouts and multi-format publishing.
  Users have access to a WYSIWYG editor, but can also edit the HTML source files directly.
- **Plain text**
  Markdown, AsciiDoc and reStructuredText have lightweight syntax, ideal for developers. (AsciiDoc and reStructuredText offer more complex features compared to Markdown.)
  To publish documentation written in a plain text format, you need a static site generator like Docusaurus or Hugo.

# Choosing an Authoring Tool

The choice between docs as code and traditional documentation equally depends on two things: **people** (who is writing and maintaining the documentation) and **features** (what functionality is mandatory for your use case).&#x20;

:::hint{type="success"}
The "best documentation tool" doesn't exist. All that exists is the **best tool for a specific scenario, within specific constraints**. Use the tables below, add your own questions, then review the list of popular authoring tools for ideas.
:::

When it comes to the people, focus on these aspects:

| **Consideration**                           | **Comments**                                                                                                                                                                 |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Technical vs non-technical contributors** | The contributors' comfort level with technical things is important - someone who only uses Word will not want to learn Git and Markdown just to add a sentence in your docs. |
| **Level of involvement**                    | Make sure your coworkers actually want to write documentation. Some genuinely prefer to just explain things and have a professional handle the writing.                      |
| **Management stance**                       | If management doesn't support their employees in contributing to documentation, it's not going to happen.                                                                    |

For the technology part, focus on these features:

| **Feature**                                               | **Comments**                                                                                                                                                                                                     |
| --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Collaboration**                                         | If multiple non-technical people have to contribute, choose tools like **Confluence** or **Google Docs**. If multiple technical people are involved, consider a **docs-as-code** workflow.                       |
| **Advanced features (versioning, variables, conditions)** | Some tools are simple to set up, but lack advanced features. Tools that do have these features vary in their ease of use.                                                                                        |
| **Scalability**                                           | For large volumes of documentation, build times matter.                                                                                                                                                          |
| **Offline documentation**                                 | Offline documentation is mandatory in some industries, so if you choose a cloud-based tool, make sure it has a way to export the documentation for offline consumption.                                          |
| **Automation support**                                    | If you want to set up a delivery pipeline for the documentation, choose a tool that supports this (e.g., command-line-only tools or those with batch versions).                                                  |
| **Customization**                                         | You may need to adapt the look and feel to your company brand. Some tools offer visual customization, while others require web development knowledge.                                                            |
| **Text editor**                                           | The choice of editor (WYSIWYG vs plain text) depends on who is contributing to the documentation.                                                                                                                |
| **Access control**                                        | If the documentation needs to be password-protected, choose a tool that supports it or budget time and resources to implement it.                                                                                |
| **Output type**                                           | Do you need to generate a website or a standalone document? Not all documentation tools generate PDFs natively, and Word support is ever rarer. The support for customizing PDF output varies from tool to tool. |
| **Migration**                                             | If you already have documentation in a different tool, consider the migration cost.                                                                                                                              |
| **Integration with external platforms**                   | If you need to publish to platforms like Salesforce or Zendesk, choose a tool that offers native export.                                                                                                         |
| **Support**                                               | Analyze the support offerings before choosing a tool—this could range from official vendor support to StackOverflow and GitHub issues.                                                                           |
| **Costs**                                                 | Most free tools still have a cost—generally a bigger time investment for setup and maintenance.                                                                                                                  |

:::hint{type="info"}
An more in-depth analysis of the decisions to make when choosing a tool is available from Brian Dominick [here](https://gist.github.com/briandominick/d4cbe11228de0ebe31cda630976af4ef).&#x20;
:::

# Authoring Tools Reference

This section describes some of the most popular authoring tools on the market (as of 2025). They are loosely grouped by category, but a definitive grouping is difficult to define, since most tools can be used for different purposes.

***

## Adobe RoboHelp

::Image[]{src="https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/ldqQNxbn1b0RKzdgqhUMW_image.png" size="70" width="690" height="156" position="center" showCaption="false"}

| **Attribute**        | **Description**                                                                                                                                                                                                               |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Website**          | [Adobe RoboHelp](https://www.adobe.com/products/robohelp.html)                                                                                                                                                                |
| **Description**      | A help authoring tool used mostly for HTML help systems. It supports conditional content, variables and output customization.\&##xA;It has a high learning curve for complete newbies, but requires no programming knowledge. |
| **Deployment**       | Desktop                                                                                                                                                                                                                       |
| **Authoring Format** | HTML, using a WYSIWYG editor                                                                                                                                                                                                  |
| **Output Format**    | HTML5, PDF, Word, CHM, etc                                                                                                                                                                                                    |

***

## MadCap Flare

::Image[]{src="https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/LeLNr0LCpc-Trls35IYqu_image.png" size="70" width="363" height="139" position="center" showCaption="false"}

| **Attribute**        | **Description**                                                                                                                                                                                                                                                                                                                                                                     |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Website**          | [MadCap Flare](https://www.madcapsoftware.com/flare/)                                                                                                                                                                                                                                                                                                                               |
| **Description**      | A help authoring tool used mostly for HTML help systems. It supports conditional content, variables and output customization.  It has a high learning curve for complete newbies, but requires no programming knowledge. Flare can integrate with MadCap Central, a cloud-based content management platform which offers version control and hosting/publishing for Flare projects. |
| **Deployment**       | Desktop (Windows-only)                                                                                                                                                                                                                                                                                                                                                              |
| **Authoring Format** | XHTML, using a WYSIWYG editor                                                                                                                                                                                                                                                                                                                                                       |
| **Output Format**    | HTML5, PDF, Word, CHM, ePub, etc                                                                                                                                                                                                                                                                                                                                                    |

***

## Adobe FrameMaker

::Image[]{src="https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/tJcdzXY7hBQ2nEJrjkDvC_image.png" size="70" width="772" height="136" position="center" showCaption="false"}

| **Attribute**        | **Description**                                                                                                                                                                                                                                                                                                                                                                            |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Website**          | [Adobe FrameMaker](https://www.adobe.com/products/framemaker.html)                                                                                                                                                                                                                                                                                                                         |
| **Description**      | A desktop publishing and structured authoring tool, best suited for complex documents published in PDF. Newer versions can also generate online help.\&##xA;It supports conditional content and variables. It has two modes of authoring: structured (for example, DITA) and unstructured.\&##xA;It has a high learning curve for complete newbies, but requires no programming knowledge. |
| **Deployment**       | Desktop                                                                                                                                                                                                                                                                                                                                                                                    |
| **Authoring Format** | Proprietary format, using a WYSIWYG editor                                                                                                                                                                                                                                                                                                                                                 |
| **Output Format**    | PDF, HTML5, ePub, RTF, Word                                                                                                                                                                                                                                                                                                                                                                |

***

## Oxygen XML Editor

![](https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/d3QZSxnxtoHQHIEnZsZ52_image.png)

| **Attribute**        | **Description**                                                                                                                                                                                                                                                                                                                                                                                          |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Website**          | [Oxygen XML Editor](https://www.oxygenxml.com/)                                                                                                                                                                                                                                                                                                                                                          |
| **Description**      | An XML authoring tool for creating structured content in DITA, DocBook and other standards. \&##xA;Offers validation, transformation scenarios and integration with content management systems.\&##xA;It has a high learning curve for complete newbies, but requires little programming knowledge. However, users must understand the basics of XML and customization for PDF output is done with XSLT. |
| **Deployment**       | Desktop                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Authoring Format** | XML, using a WYSIWYG editor                                                                                                                                                                                                                                                                                                                                                                              |
| **Output Format**    | HTML, PDF, ePub, Word, XML, DITA                                                                                                                                                                                                                                                                                                                                                                         |

***

## RWS Tridion Docs

![](https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/k8RVp-Vr1G9NLGmyPJ1Ih_image.png)

| **Attribute**        | **Description**                                                                                                 |
| -------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Website**          | [Tridion Docs](https://www.rws.com/tridion-docs/)                                                               |
| **Description**      | Enterprise-level documentation management system for creating, managing and delivering DITA structured content. |
| **Deployment**       | Cloud                                                                                                           |
| **Authoring Format** | XML, using a WYSIWYG editor                                                                                     |
| **Output Format**    | HTML, PDF, Word, XML                                                                                            |

***

## Microsoft Word

![](https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/quxZVopWJyx_8gaeVSCx8_image.png)

| **Attribute**        | **Description**                                                                                                                                                                                                                                                                                                                        |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Website**          | [Microsoft Word](https://www.microsoft.com/en-us/microsoft-365/word)                                                                                                                                                                                                                                                                   |
| **Description**      | The most used word processor. It supports basic styles, templates and review features like track changes and comments.                \&##xA;Not ideal for complex documents due to lack of support for topic-based authoring and conditions, but available on almost every computer.\&##xA;It is easy to learn how to do basic tasks. |
| **Deployment**       | Desktop                                                                                                                                                                                                                                                                                                                                |
| **Authoring Format** | Office Open XML, using a WYSIWYG editor                                                                                                                                                                                                                                                                                                |
| **Output Format**    | DOCX, PDF, RTF, HTML (single-page)                                                                                                                                                                                                                                                                                                     |

***

## Google Docs

![](https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/NzYSXJljZtBGrPZ5WV0mO_image.png)

| Attribute           | Description                                                                                                                                                                        |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Google Docs Website | [Google Docs](https://docs.google.com/)                                                                                                                                            |
| Description         | Word processing tool available online, with limited features such as basic styles, templates and review.\&##xA;Not ideal for complex documents, but is easy to  learn and is free. |
| Deployment          | Cloud                                                                                                                                                                              |
| Authoring Format    | WYSIWYG editor                                                                                                                                                                     |
| Output Format       | DOCX, PDF, HTML, RTF                                                                                                                                                               |

***

## Static Site Generators (MkDocs, Sphinx, Jekyll, Hugo, etc)

![](https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/RsiZsJkuH8dDRLjZQKgnn_image.png)

| **Attribute**        | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Website**          | [MkDocs](https://mkdocs.org/) / [Sphinx ](https://www.sphinx-doc.org/)/ [[https://jekyllrb.com/](https://jekyllrb.com/)](https://jekyllrb.com/)[https://jekyllrb.com/](https://jekyllrb.com/) Jekyll  / [[https://gohugo.io](https://gohugo.io)](https://gohugo.io)[https://gohugo.io](https://gohugo.io) Hugo \&##xA;An extensive list of static site generators is [[https://jamstack.org/generators/](https://jamstack.org/generators/)](https://jamstack.org/generators/)[https://jamstack.org/generators/](https://jamstack.org/generators/) available on JamStack . |
| **Description**      | Lightweight tools that convert plain text files into static websites. \&##xA;Popular in developer communities due to support for authoring in any text editor and lack of upfront costs. \&##xA;Support various features out-of-the-box (depending on the generator) and are extensible, but require programming/DevOps knowledge to extend and maintain.                                                                                                                                                                                                                 |
| **Deployment**       | Desktop                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Authoring Format** | Markdown, AsciiDoc, reStructuredText, using a plain text editor (VSCode, NotePad++, Sublime, etc)\&##xA;(depending on the generator)                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Output Format**    | HTML, PDF (with additional plugins)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

***

## GitBook

![](https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/Kq326-kGt8hZhqAD0CueX_image.png)

| **Attribute**        | **Description**                                                                                  |
| -------------------- | ------------------------------------------------------------------------------------------------ |
| **Website**          | [GitBook](https://www.gitbook.com/)                                                              |
| **Description**      | A lightweight platform for writing and publishing documentation, popular with development teams. |
| **Deployment**       | Cloud                                                                                            |
| **Authoring Format** | Markdown, using a WYSIWYG editor                                                                 |
| **Output Format**    | HTML, PDF                                                                                        |

***

## Paligo

![](https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/7p8WPndxs4w7sW5a25V-P_image.png)

| **Attribute**        | **Description**                                                                                      |
| -------------------- | ---------------------------------------------------------------------------------------------------- |
| **Website**          | [Paligo](https://www.paligo.net/)                                                                    |
| **Description**      | Structured authoring tool based on DocBook XML. Supports multi-channel publishing and content reuse. |
| **Deployment**       | Cloud                                                                                                |
| **Authoring Format** | XML, using a WYSIWYG editor                                                                          |
| **Output Format**    | HTML, PDF, ePub, Word, etc                                                                           |

***

## Confluence

![](https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/AQvW-LmzV9aJsFbfzIxq-_image.png)

| **Attribute**        | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                            |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Website**          | [Confluence](https://www.atlassian.com/software/confluence)                                                                                                                                                                                                                                                                                                                                                                                |
| **Description**      | A wiki platform by Atlassian. \&##xA;It is popular for its collaboration features, for ease of authoring for non-technical people and integration with Jira and other Atlassian tools.\&##xA;Supports advanced features like conditional content and variables only through plugins, such as those offered by [[https://www.k15t.com/](https://www.k15t.com/)](https://www.k15t.com/)[https://www.k15t.com/](https://www.k15t.com/) K15t . |
| **Deployment**       | Cloud                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Authoring Format** | HTML, using a WYSIWYG editor                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Output Format**    | PDF, HTML                                                                                                                                                                                                                                                                                                                                                                                                                                  |

***

## Archbee

![](https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/ZbGZXWHJ0woldmIbu5Zwb_image.png)

| **Attribute**        | **Description**                                                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Website**          | [Archbee](https://archbee.io/)                                                                                                        |
| **Description**      | A cloud-based knowledge management and documentation platform. Supports conditional content, variables, versioning and collaboration. |
| **Deployment**       | Cloud                                                                                                                                 |
| **Authoring Format** | Markdown, using a WYSIWYG editor                                                                                                      |
| **Output Format**    | HTML, PDF                                                                                                                             |

***

## Document360

![](https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/di9DnpMgB3D2GIqWKGut7_image.png)

| **Attribute**        | **Description**                                                                                                                                                      |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Website**          | [Document360](https://document360.com/)                                                                                                                              |
| **Description**      | A cloud-based knowledge management system for creating internal documentation and knowledge bases. \&##xA;Supports conditional content, variables and collaboration. |
| **Deployment**       | Cloud                                                                                                                                                                |
| **Authoring Format** | Markdown or WYSIWYG Editor                                                                                                                                           |
| **Output Format**    | HTML, PDF                                                                                                                                                            |

***

## ReadMe

![](https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/RlkP0tika0I6U30N-Y-nJ_image.png)

| **Attribute**        | **Description**                                   |
| -------------------- | ------------------------------------------------- |
| **Website**          | [ReadMe](https://readme.com/)                     |
| **Description**      | Platform designed for creating API documentation. |
| **Deployment**       | Cloud                                             |
| **Authoring Format** | Markdown, using a WYSIWYG editor                  |
| **Output Format**    | HTML, PDF                                         |

***

## Redocly

![](https://api.archbee.com/api/optimize/fh9Kla9lm_P4ujQJfZyJC/mf5GcVuqOGYbmVPsOE5Jg_image.png)

| **Attribute**            | **Description**                                                                                                  |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| **Website**              | [Redocly ](https://redoc.ly/)/ Reunite                                                                           |
| **Description**          | Reunite, part of the Redocly offering, is an API documentation platform for managing and versioning API content. |
| **Deployment**           | Cloud                                                                                                            |
| **Authoring** **Format** | OpenAPI, Markdown                                                                                                |
| **Output** **Format**    | HTML                                                                                                             |

