Getting started
Writerside is a JetBrains IDE based on the IntelliJ platform. Use it to author, build, test, and publish technical documentation.
Install Writerside
Download the Writerside installer.
Run the installer.
Watch this short video for an overview of the Writerside UI and main features:
Create new documentation project
In the Welcome to Writerside dialog, click New Project.
If you already have a project open, select
from the menu bar.In the New Project wizard, select New Project.
Specify the name and location for your new project.
If you do not want to start with an empty project, select the options to create the first instance and topic in your new project.
Click Create.
Once you have a documentation project with a help instance, you can add topics to it and start writing content. Click in the left-side tool window bar to open the Writerside tool window and start adding content.
Create topics
Create a topic from scratch
In the Table of Contents pane of the Writerside tool window, click and select Empty MD Topic to add a Markdown topic or Empty XML Topic to add a semantic markup topic.
For more information about topics, see Topic formats.
Specify a title and filename for the topic.
Create a topic from template
Writerside includes built-in templates for different types of content that contain some boilerplate structure to give you something to get started with.
In the Table of Contents pane of the Writerside tool window, click and select a template under Topic from Template.
Specify a title and filename for the topic.
Preview topics
Use the Writerside Preview tool window to preview the topic you are working on exactly the way it will be published.
Open the Writerside Preview tool window
Writerside opens the Writerside Preview tool window the first time you open any topic in the editor. If you close the preview and want to open it again, do one of the following:
Click the Writerside Preview tool window button .
From the main menu, select
.Right-click any topic in the Table of Contents and select Preview Topic.
For more information, see Preview topics.
Change the table of contents
In the Table of Contents pane of the Writerside tool window, drag topics around to change their order and hierarchy.
You can also edit the .tree file to change the TOC. For this, right-click the help instance and select Open TOC File.
For more information, see Table of contents.
Build your help instance
In the Writerside tool window, click Export To and then select Web Archive.
For more information, see Build locally.
If you want to build and publish documentation using CI/CD, we have instructions for GitHub, GitLab, and TeamCity Cloud.
If you want to use another CI/CD to build documentation, drop us a message at writerside@jetbrains.com, and we will provide you with a Docker image.
Feedback and support
Report an issue
Report any issues, usability improvements, or feature requests to our YouTrack project (you will need to register).
Get support and share feedback
Join the JetBrains Writerside Slack workspace.
Before you do, read our code of conduct. We assume that you have read and acknowledged it before joining.
You can also email us at writerside@jetbrains.com.