Switch sectionKnowledge base

Pages and the editor: how to create and format an article

Learn how to create an article, insert blocks with the slash key, mention people, and find articles in the Library.

An article in the knowledge base is a text page: an instruction, a policy, notes. You can build it from headings, lists, tables, pictures, callouts and links to other articles and tasks. Articles live in a project’s knowledge base and nest inside one another like a tree.

How to create an article

  1. Press Wiki in the column of buttons at the left edge of the window. It opens the knowledge base of the project you opened last.
  2. In the Library, press New and choose Page.
  3. The new article opens. Type a title, up to 200 characters. Until you type one, the article is called Untitled.

You can also make a sub-page from inside another article: type / and choose Sub-page. A row linking to it appears in the parent’s text.

How to insert blocks

The text of an article is made of rows, called blocks. Type / on an empty row and the insert menu opens. Besides the usual blocks, it has:

  • Callout, a highlighted note with an icon;
  • Toggle list;
  • Link to page, which points to an article, a board or a task;
  • Table of contents;
  • Button, which opens a link or a page, inserts blocks, or shows a confirmation;
  • Equation;
  • Sub-page and Board.

The usual blocks are headings, lists, a to-do list, a table, a picture, video, a file and a code block. A code block set to Mermaid draws a diagram.

To the left of each row there is a handle, ⠿. Drag it to move the row, or click it to open the Block menu: turn the row into another kind of block, duplicate it, color it, copy a link to it.

Type @ and Syncra offers people and articles. If the mentioned person cannot see the project, they get no notification and the editor tells you so. When you paste a link, you choose how it looks: Mention, URL or Bookmark.

Page settings

Hover over the article’s title and the buttons Add icon and Add cover appear next to it. A cover is a JPG, PNG, WebP or GIF picture. You switch the width in the article’s ⋯ menu: Use full width or Use narrow width. An article saves itself while you type. ⌘S does nothing, because you never need to save by hand. (On Windows, ⌘ means Ctrl.)

How to find an article

The Library is a table of the project’s articles. Its tabs are All pages, Recents, Favorites and Published. It has a Search pages field, filters, and columns such as Title, Author, Last edited and Created. The star Add to favorites pins an article for you alone.

In the sidebar, articles appear in two sections: Favorites and Pages. The ⋯ menu on an article’s row has Rename, Duplicate, Move to… and Delete.

On a phone

In the mobile version the create buttons are called New article and New board.

Updated:

More in “Knowledge base”

Back to the category

Didn't find an answer?

Message us on Telegram. A person from the Syncra team replies.

Message us on Telegram