Authoring Tools
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:
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. 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).
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. |
An more in-depth analysis of the decisions to make when choosing a tool is available from Brian Dominick here.
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

Attribute | Description |
|---|---|
Website | |
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

Attribute | Description |
|---|---|
Website | |
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

Attribute | Description |
|---|---|
Website | |
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

Attribute | Description |
|---|---|
Website | |
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

Attribute | Description |
|---|---|
Website | |
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

Attribute | Description |
|---|---|
Website | |
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

Attribute | Description |
|---|---|
Google Docs Website | |
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)

Attribute | Description |
|---|---|
Website | |
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

Attribute | Description |
|---|---|
Website | GitBook |
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

Attribute | Description |
|---|---|
Website | Paligo |
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

Attribute | Description |
|---|---|
Website | |
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/ K15t . |
Deployment | Cloud |
Authoring Format | HTML, using a WYSIWYG editor |
Output Format | PDF, HTML |
Archbee

Attribute | Description |
|---|---|
Website | Archbee |
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

Attribute | Description |
|---|---|
Website | |
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

Attribute | Description |
|---|---|
Website | ReadMe |
Description | Platform designed for creating API documentation. |
Deployment | Cloud |
Authoring Format | Markdown, using a WYSIWYG editor |
Output Format | HTML, PDF |
Redocly

Attribute | Description |
|---|---|
Website | Redocly / 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 |