How to create a Confluence wiki for your company

Cards on top of a Confluence screen

How to create a Confluence knowledge bas...

How a Confluence knowledge base can benefit your business

How a Confluence knowledge base can bene...

App news: Ratings for Confluence is being retired

App news: Ratings for Confluence is bein...

Is your business using Confluence as a wiki yet? If not, why not? Confluence is the perfect tool for gathering and sharing information between teams. With real-time collaboration, in-line comments and a range of privacy and permission settings, Confluence faciliates teamwork and knowledge managment for teams everywhere - even remote and asynchronous ones.

Here's exactly what you need to consider before building your Confluence wiki.

What is a wiki

A wiki is an online collaboration tool that usually takes the form of an open-editing web page or website. Users can add, change or remove content on any page they have permission to edit.

When used in place of or alongside an intranet, a wiki enhances teamwork and collaboration across your organisation. It acts as a single source of truth for company updates, documentation and resources, and becomes even more powerful when tailored to suit the needs of individual teams and projects. 

Why use Confluence for your wiki?

When it comes to building your wiki, it’s important to identify the right software to use. You’ll likely have sensitive information to upload, multiple users and a strong need for flexibility. These requirements demand a solution that is secure, customisable and responsive - which is where Confluence comes in. 

Defined by Atlassian as a “collaborative workspace where teams and knowledge meet to achieve great things”, Confluence integrates with many other popular tools, is extremely customisable and boasts high levels of security. It’s suitable for large and small businesses and has inbuilt templates and interactive add-ons, making it an excellent all-rounder for use as a company wiki. Here’s how to get started:

Steps for success when building your Confluence wiki

1. define your business requirements.

Start by asking what business problem you want to solve. Is your aim to create a streamlined internal hub where colleagues receive general company updates? Or is your requirement more function-specific? Perhaps you want to create channels where your teams can work productively together, host documents and report back on their progress. Confluence can be used effectively in all of these scenarios, as long as it’s clearly structured and organised . 

Screenshot of an internal marketing hub

2. Identify the information you want on your wiki

Part of the beauty of Confluence is that it is designed to be constantly evolving and growing over time. And while it does facilitate the ongoing addition of information (for example, meeting notes and brainstorm outputs), you should aim to have the core structure and key documents in place before you publish your wiki. 

If you’re setting up team hubs, create a brief for each department that explains what they should contribute to set up their Confluence space. This could include profiles, strategy documents and project overviews. Make sure your intranet has essentials such as company guidelines and forms, digital and marketing assets, and relevant HR and onboarding information.

Screenshot of internal marketing hub

3. Think about your structure and organisation

Confluence administrators often struggle with organisation. In large companies with many users and frequent updates, it can be challenging to maintain a clear wiki structure. That makes it critical to understand not only what you want your wiki to be used for, but how users will interact with it. 

Consider drafting a site structure that sets out the hierarchy of your spaces and pages and how they will connect. Think about the main groups you want your content and teams to be split into - for example, separate hubs for HR, marketing, sales and project management, all connected from the homepage and linking out to project pages. Your Confluence wiki will naturally grow over time, but an established structure will help to group relevant information together and maintain a tidy intranet in years to come.

4. Use the right tools to enhance your Confluence wiki

Once you’ve made your plan and received input from your teams, it’s time to build your wiki and establish your single source of truth. Confluence has plenty of inbuilt functionality to get you started, but when it comes to customising and personalising your spaces and pages, add-ons like Content Formatting Macros can help to push your wiki even further. These macros are ideal for organising and structuring your spaces, making them more readable as well as adding design flair and engaging features. 

Use macros like Progress Bars, Buttons and Cards to visualise and conceptualise content, and keep information tidy and organised with Tabs and Tooltip macros. There is a range of Confluence tools you can use to improve the wiki user experience - you can find out more in our blog on Confluence formatting tips . 

Confluence wiki best practices

Ready to create your wiki?

Whether you aim to simply update your employees on the latest business news or to provide team members with a fully customisable, collaborative workspace, a Confluence wiki could be the perfect solution. With the right planning, organisation and creativity, you’re ready to get started. 

Click below to start using Content Formatting Macros for Confluence for free.

Illustration of three people building a confluence page

Ready for more wiki inspiration?

Read our follow-up blog to discover how to customise your Confluence wiki with Content Formatting Macros.

How to create a Confluence knowledge base in six easy steps

How to create a Confluence knowledge base in six easy steps

How a Confluence knowledge base can benefit your business

How a Confluence knowledge base can benefit your business

App news: Ratings for Confluence is being retired

App news: Ratings for Confluence is being retired

How to create forms in Confluence Cloud for data collection

How to create forms in Confluence Cloud for data collection

The web browser you are using is out of date, please upgrade .

Please use a modern web browser with JavaScript enabled to visit

Write Agile Documentation: User Stories & Acceptance Tests

Free online content available in this course.



Last updated on 4/11/22

Create a Confluence Site and Your First Wiki Pages

Popular wiki products.

There are several wiki products out there that are worth considering, such as:

Confluence - developed by Atlassian, this is by far the most popular wiki.

Notion - a wiki with great design and free to use (until you reach a certain number).

As I said, Confluence is the most popular wiki used in companies today, so we'll use it to store user stories and acceptance tests in the following chapters.

Set Up Confluence

There are a few steps to creating a wiki with Confluence:

1. Create an account on Confluence  using this link .

2. Make sure to write down your password somewhere secure. You'll get an email with a link to confirm.

3. Start a Confluence trial using this using this link .

Click on the try it free button

4. Choose a site name. It can be anything you like and will appear in your wiki URL (e.g., if your company were called Google, then you could use the name 'google' and the URL to your wiki would be

Choose a site name (any name at all will do!) and fill out basic information like name email and password

5. Create a space called Product . Spaces are areas in Confluence (e.g., You would store the marketing documentation in the marketing space and the product documentation in the product space).

name and create your space by clicking continue to store your work

6. Create your first wiki page and hit save! 

Create Your First Wiki Page

Let's go back to an example from a previous chapter:

We decided to look at a feature (called a quiz). 

We went through a process to write 14 user stories for this quiz feature.

We then wrote acceptance tests for some of these user stories.

Now, let's use a Confluence wiki to store this information so the team can access it:

Create a wiki page for the quiz feature. 

Create 14 user story pages.

On the Quiz page, write down the user stories and add a link to each individual user story page.

Add the acceptance tests (that belong to a given user story) on that user story's page. 

Create a Feature Page for the Quizzes

Let's begin by creating the following sections  on the wiki page and then fill them:

Background - Add a general text description of the feature.

A background section adds some general context

Screenshots - A picture can tell a thousand words, so put one or two screenshots (graphic designs) here.

Screenshot of a quiz

User stories - Create a table with one user story per row and a link to a full wiki page (which will eventually include the user story details) beside it. 

The User Stories section is the most important because it links to each story's wiki page

For corporate or product documentation, there are typically some existing related wiki pages that may be useful to link to here to provide more context.

A links section allows you to add references to related material

Address a Few General Concepts

The following general wiki concepts were demonstrated in the screencast, but try them out for yourself:

Linking from any wiki page to any other.

Text formatting into Heading 1, Heading 2, paragraph, etc. (which helps you make nice heading sections).

Creating tables to present information (we put our user stories into a table).

Inserting images or documents (this is easily done, which means you can store all relevant documentation (including Microsoft PowerPoint slides, Microsoft Word/Excel documents, or PDF documents) all in one central place - your wiki!

Make sure you are comfortable with these concepts before moving on. If not, watch the screencast again!

Let’s Recap!

Wikis are a great tool to help the team achieve better transparency and understanding of their work.

Confluence and Notion are very popular wiki platforms in use by many organizations.

Wikis are a good way to help document your work.

Now that you have created your own wikis, you're ready to create the perfect user stories. So let’s get to it in the next chapter!

Additional Resources

Atlassian provides a platform where you can download free Jira software and service management tools to assist you. You  can access it here .

Notion (a newer tool) repository allows you to blend your everyday work apps into one. It's the all-in-one workspace for project management. You can access it here .

Getting started with Confluence

We're happy to see that you're enjoying our courses (already 5 pages viewed today)! You can keep checking out our courses by becoming a member of the OpenClassrooms community. It's free!

You will also be able to keep track of your course progress, practice on exercises, and chat with other members.

Example of certificate of achievement

Only Premium members can download videos from our courses. However, you can watch them online for free.

Find Help (FAQs)

Don't See What You're Looking For?

how to create a wiki page on confluence

Help Us Improve

how to create a wiki page on confluence

Browse by Collection

How do I create a new page in my Confluence wiki?

In Confluence, you can create links to pages that you intend to create at a later point. This type of a link is an undefined link and is indicated with a plus sign. Clicking on the link brings up the 'Add Page' screen. Follow the same steps outlined above to create the page.

Rate this Article

Feedback: Correct or Suggest an Article | Request Help

Ask a question

Start a discussion.

Community resources

Atlassian Community Events


Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar

Level 1: Seed

25 / 150 points


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Join now to unlock these features and more

Come for the products, stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner

Import Wiki-Pages to Confluence

Victor Martinez

You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.

Nithin C N

Suggest an answer

People on a hot air balloon lifted by Community discussions

Still have a question?

Get fast answers from people who know.

Was this helpful?

Confluence Support

Documentation, knowledge base.

Jira Software

Project and issue tracking

Jira Service Management

Service management and customer support

Jira Work Management

Manage any business project

Document collaboration

Git code management

Usage and admin help

Answers, support, and inspiration

Suggestions and bugs

Feature suggestions and bug reports


Product apps

Billing and licensing

Frequently asked questions

Confluence Markup

On this page

Related content.

Still need help?

The Atlassian Community is here for you.

Ask the community

This page describes the wiki markup used on some administration screens in Confluence.

Wiki markup is useful when you want to do one of the following:

Note: You cannot edit content in wiki markup.  Confluence does not store page content in wiki markup. Although you can enter wiki markup into the editor, Confluence will convert it to the rich text editor format immediately. You will not be able to edit the wiki markup after initial entry.

Can I type wiki markup into the editor?

On this page:

Yes. You can type wiki markup directly into the editor, and Confluence will convert it as you type. (You cannot edit the wiki markup after conversion.)

Can I insert markdown?

Confluence supports inserting content in markdown. This is often used in ReadMe files. See  Markdown syntax guide  for some examples of markdown syntax.

To insert markdown in the editor:

As with wiki markup, Confluence will convert your markdown to the rich text editor format. You will not be able to edit your content using markdown.

To format a line as a heading, type "hn." at the start of your line, where n can be a number from 1 to 6.

Wiki markup allows you to create bulleted or numbered lists, and is flexible enough to allow a combination of the two list types.

Simple lists

Use the hyphen (-) to create simple lists with square bullets. Make sure there's a space between the hyphen and your text.

Bulleted lists

Use the asterisk (*) to create bullets. For each subsequent level, add an extra asterisk. Make sure there is a space between the asterisk and your text.

Numbered lists

Use the hash (#) to create numbered lists. Make sure there is a space between the hash and your text.

A second level of hashes will produce a sub-list, such as the alphabetical sub-list shown below.

You can use a third level of hashes to produce a sub-sub-list.

Note: In numbered lists as described above, the format of the 'number' displayed at each list level may be different, depending upon your browser and the style sheets installed on your Confluence instance. So in some cases, you may see letters (A, B, C, etc; or a, b, c, etc) or Roman numerals (i, ii, iii, etc) at different list levels.

Mixed lists

You can create two types of tables.

Table Type 1

Allows you to create a simple table with an optional header row. Once you've added this type of table, you can set the width of the columns using the table controls in the toolbar .

Use double bars for a table heading row.

What you need to type:

What you'll get:

You can also use a vertical header.

Table Type 2

This method uses section and column macros to create the table, and allows you to specify the width of the columns in the markup.

What you need to type

What you'll get

Text for this column goes here. This is the smaller column with a width of only 30%.

Text for this column goes here. This is the larger column with a width of 70%.

Advanced Formatting

Color and other formatting.

To add color and other formatting to your tables, you can use the Panel Macro within columns. More table-formatting options may be available if your Confluence administrator has installed additional macros .

Here's an example of how to embed lists in a table:

Text Effects

Use the markup shown in the examples below to format text.

Text Breaks

Paragraph break.

In wiki markup, a paragraph is a continuous line of text ending in two carriage returns. This is equivalent to a continuous line of text followed by a blank line.

When rendered into HTML, the result is a line of text wrapped in a set of <p></p> tags.

Confluence provides two options for forcing a line break within a paragraph of text:

When rendered into HTML, the result is a paragraph of text that is split into separate lines by <br> tags, wherever a forced line break appears.

The examples below show how to use explicit line breaks.

If you wish to use multiple consecutive line breaks, each should be separated by a space character. For example, use this for two consecutive line breaks:

Horizontal Rule

To create a horizontal line across the width of your page or content block, type four dashes (like this: ----) at the beginning of a line, then press Enter or space.

Make sure that the dashes are on a separate line from the rest of the text.

You can use wiki markup to add hyperlinks to your text.

Note that Confluence treats headings as anchors, so you can link to headings using this pattern: [spacekey:pagename#headingname], where headingname is case-sensitive and must be entered without spaces.

For each of these link forms:

You can display images from attached files or remote sources.

Available HTML image tags include:

Page Layouts

There is no wiki markup representation for page layouts.

Storage format and wiki markup examples have been included in the documentation for each macro .

Was this helpful?

Bitbucket Support


Get started with Bitbucket Cloud

New to Bitbucket Cloud? Check out our get started guides for new users.

Join or create and manage workspaces in Bitbucket Cloud

A workspace contains projects and repositories. Learn how to join or create a workspace, control access, and more.

Set up and work on repositories in Bitbucket Cloud

Whether you have no files or many, you'll want to create a repository. These topics will teach you everything about repositories.

Build, test, and deploy with Pipelines

Pipelines is an integrated CI/CD service built into Bitbucket. Learn how to build, test, and deploy code using Pipelines.

Manage your plans and settings in Bitbucket Cloud

Learn how to manage your plans and billing, update settings, and configure SSH and two-step verification.

Integrate Bitbucket Cloud with apps and other products

Learn how to integrate Bitbucket Cloud with Jira, Marketplace apps, and use the Atlassian for VS Code extension.

Build third-party apps with Bitbucket Cloud REST API

Learn everything you need to know about how to build third-party apps with Bitbucket Cloud REST API, as well as how to use OAuth.

Get advisories and other resources for Bitbucket Cloud

Access security advisories, end of support announcements for features and functionality, as well as common FAQs.

Become a member of our fictitious team when you try our tutorials on Git, Sourcetree, and pull requests.

Create and manage projects in Bitbucket Cloud

Projects makes it easier for members of a workspace to collaborate by organizing your repositories into projects.

Usage and admin help

Answers, support and inspiration

System Status

Cloud services health

Suggestions and bugs

Feature suggestions and bug reports


Product apps

Billing & licensing

Frequently asked questions

Create or edit a wiki page

The wiki in your repository is a place to keep documents for everything related to your project. If you don't see an wiki on your repository, you can  enable it or ask an administrator to do so .

Create a page

Go to the repository's  Wiki  link in the left panel. By default, you see the wiki  Home  page.

Click  Create page  at the top to create a new wiki page.

Edit a page

To see a list of all your wiki pages, click the link with your repository's name under the Wiki heading.

Click the wiki page that you want to update.

Click  Edit  in the top right.

After making your changes to the page content, enter a comment in the  Message  text box. This comment appears as a commit message and as part of the page history above the relevant commit entry.

Click  Save .

Was this helpful?

Additional Help

More in this guide

View all products

Jira Software

Project and issue tracking

Content collaboration

Jira Service Management

High-velocity ITSM

Visual project management

New products from Point A

Innovations from Atlassian

how to create a wiki page on confluence

Teamwork directory

how to create a wiki page on confluence

Developer experience platform


Connect thousands of apps for all your Atlassian products

Browse by solution

Agile & devops.

Run a world-class agile software organization from discovery to delivery and operations

IT Service Management

Enable dev, IT ops, and business teams to deliver great service at high velocity

Work Management

Empower autonomous teams without losing organizational alignment

Browse by team type

Small business, by team size.

Great for startups, from incubator to IPO

Get the right tools for your growing business

Learn how we make big teams successful

By team function

Plan, build, & ship quality products

Bring together a winning strategy

Streamline people management

Operate securely and reliably

Run your business efficiently

Provide great service and support

Simplify all finance processes

Incident Response

Respond, resolve, & learn from incidents

Apps that enhance Atlassian products

Docs and resources to build Atlassian apps

Trust & security

Compliance, privacy, platform roadmap, and more

Work Life blog

Stories on culture, tech, teams, and tips


Guides to all of our products

Atlassian Migration Program

Tools and guidance for migrating

Cloud roadmap

Upcoming feature releases

Purchasing & licensing

FAQs about our policies

Support services

Enterprise services.

Personal support for large teams

Partner support

Trusted third-party consultants

Atlassian Support

A resource hub for teams and admins

Learn & connect

Our mission and history

Job openings, values, and more

Atlassian University

Training and certifications for all skill levels

Atlassian Community

A forum for connecting, sharing, and learning

Set up your site and spaces

Before you begin this tutorial, sign up for your free trial  of Confluence Cloud. This guide will help you set up your first project, so keep this tab open while you sign up. Go on, we'll wait here. 

This guide is for Confluence Cloud. If you’re interested in one of our self-managed options, > " data-label-english="go here >> " href="/software/confluence/pricing?tab=data-center">go here >> 

If you’re a Confluence Data Center or Server user, check out this tutorial on how to create and edit pages in Confluence.

Step 1: Learn about spaces

Your Confluence site is organized into spaces . Spaces are collections of related pages that you and other people in your team or organization work on together. Most organizations use a mix of team spaces , software project spaces , documentation spaces , and knowledge base spaces :

Use team spaces to encourage team members to work together toward large-scale goals and OKRs. For example, you might create a team space for your Marketing team to align on OKRs, stay up-to-date on brand guidelines and messaging pillars, and gain insight into your marketing organization’s high-level strategy.

Use software project spaces to keep track of individual initiatives and projects. For example, you might create a project space to serve as a single source of truth for everything related to a new feature your company is developing, from product requirements and feature specifications to meeting notes and retrospectives.

Use documentation spaces to create and organize technical documentation for your products and services, so it’s easy for anyone to use.

Use knowledge base spaces to store and surface answers to common questions, such as policy clarifications and IT solutions. If you have a subscription to Jira Service Management, you can integrate it with your Confluence site to share knowledge base articles with customers.

Use your personal space as a sandbox to organize your notes, keep track of personal OKRs and goals, and draft proposals for projects before they make it to the roadmap. Connect with your team by writing blog posts to introduce yourself or share what you’re working on.

Before you dive into creating a bunch of spaces, think about how your organization will use Confluence Cloud. Here are some common use cases:

Step 2: Create a space

Once you know what kinds of spaces your organization will need, it’s time to create your first space.

Once you’re done, you’ll land in the space Overview . This is where you can let people in your organization know what your space is for and who uses it. In the next step, you’ll learn how to customize the overview for your new space.

Step 3: Customize your space overview

Each space comes with an Overview that you can use to tell team members and other stakeholders all about the purpose of your space and what they will find in it. If you created your space from a space template, your overview will come with built-in features to help you make the most of your space. Even so, you may find adding your own touch lets you turn your overview into the perfect hub for everything your team needs.

Example Confluence space overview

Try these tricks to make your overview pop:

For more information on how to craft a great overview page, check out the Confluence Cloud documentation or this blog post .

Need a quick win? Get started fast with the team homepage template from Hubspot.

Step 4: Organize your content

Now that you’ve created your first space, it’s time to get organized. The goal is to make your space easy to navigate so team members and other stakeholders can find the content they’re looking for quickly.

To learn more about navigation, see Guide 4: Navigate Confluence .

Use parent pages to group similar content

In Confluence, you can nest pages underneath other pages, creating a hierarchy of content in each space. This hierarchy is reflected in the page tree, which appears in the space sidebar to the left of the active page.

To use the page tree to your advantage, create a page for each task or project your team is involved with and nest related child pages underneath it. For example, if your team conducts retrospectives every 2 weeks, you might have a top-level page called “Retrospectives” with a page for each retrospective you’ve conducted nested beneath it.

The example below shows how one Atlassian team utilizes this strategy to organize their space:

Retrospectives space

Create shortcuts for important pages

Confluence lets you create unique space shortcuts – links that are pinned to the space sidebar, above the page tree – for every space in your site. Use these to highlight important content so it’s easy to find.

To create your first space shortcut, navigate to your space and select + Add shortcut in the sidebar. For more information on space shortcuts, including how to edit or remove existing space shortcuts, see Customize your space .

Label pages and attachments

Labels make it a breeze to identify related pages and attachments, so team members and other stakeholders can find what they’re looking for.

*If you’re editing the page instead of viewing it, select the more actions menu (•••) in the top right, then select Add labels .

Give labels transparent and meaningful names. For example, the label you use for meeting notes might be called meeting-notes or meetings . If you add that label to every page you use to capture meeting notes, then you can browse all your meeting notes – within a single space or across your entire Confluence site – just by selecting the label. You can also display all pages with the same label on a page or search content by label to find relevant pages and attachments more easily. For more information about labels, see Use labels to organize your content .

If you apply a label to a page template, that label will automatically be applied to any page you create with that template.

Keep content organized

Set aside time to review the content in your space, delete or archive obsolete content, and move pages around to maintain the structure you want. If you’re a site admin, set up rituals around maintaining your space with people on your team and encourage space admins to carve out time to review and update their spaces with the people who use them.

For more information, see this blog post .

Step 5: Manage users and permissions

As a Confluence admin or site admin with a paid subscription to Confluence, you can manage users, groups, and permissions manually, or you can turn on public signup and let users create their own accounts. For information about permissions in the free plan, see our documentation .

Manage global permissions

To manage global permissions, you must have the Confluence administrator permission.

Global permissions  apply to your entire site and let you control:

Licensed users

To edit global permissions for licensed users:

Changes to global permissions aren’t active until you click Save .

You can search and filter user groups while in edit mode.

Unlicensed users

There are two ways to manage users on Confluence who don’t have Confluence licenses:

Jira Service Management unlicensed access

Anonymous access

Manage space permissions

To edit space permissions, you must be a space administrator. If you are a Confluence administrator, you can recover space administrator permissions for any space on your site. For more information, see What are space permissions ?

Space permissions let you control:

Confluence is open by default. That means that unless you make space permissions more restrictive, everyone with access to your Confluence site can access content in any given space. Space administrators can set permissions when they create a new space and adjust them later. Anyone who can edit a page can edit its restrictions.

To get to space permissions:

*The Permissions tab will only appear if you're a space admin in that space.

You can manage space permissions for individuals or for entire groups. If your site is public, you can also grant anonymous access to an individual space. For more information, see  Set up public access .

To learn more about all you can do with space permissions, see  Assign space permissions .

How should I set up space permissions?

While some Confluence customers use the same permissions scheme for every space on their site, others set space permissions differently for spaces with different purposes or use cases.

Invite team members to your site

Once you’ve set up your site and configured overall permissions, it’s time to invite team members to start using Confluence Cloud (along with any other Atlassian products on your site).

*This only applies to team members with the Basic role.

As a site admin, you can update roles, access, and groups for users at any time. You can also remove a user by revoking site access, deactivating their account, or even deleting it (for example, when an employee leaves your company). For more information, see Invite and remove users .

Confluence Overview

Learn what Confluence is and whether it’s a good fit for your team or organization.

Create content in Confluence

Learn how to create rich, dynamic content in Confluence.

how to create a wiki page on confluence

JIRA Tutorial for NGOs. Part 5 – Simple tricks in Confluence for creating a Wiki page

Maciej neumann.

creating a Wiki page

Share This Post

We don’t get any financial benefits from creating Jira tutorials. We only offer this program as one of the best project management tools. Nonprofit organizations can apply for Jira for free.

We all know and love Wikipedia. This is not only one of the best ways to check your information. This is also now one of the most popular formats for knowledge sharing on the internet. And not without reason. You can find the information you need very fast and almost intuitively. Just check the table of contents and find the paragraph with the knowledge you need right this moment.

But not all knowledge should be shared with everyone on the internet. Companies and organizations or even non-profits are gathering a lot of information. Amounts of data that institutions are creating can be enormous if not overwhelming. That is why a system, that can help employees go through all that information efficiently and quickly is so needed. Especially for the new people in the organization, that want to learn from the past projects and study some cases. There is no need to invent something from scratch. Gathering information in the form of wikis is proved to be a very successful system. For example, IT companies use it to manage the documentation for the software.

Thanks to Confluence we can create our own, first simple version of Wiki-style article. Just for the eyes of the people of the company. Here is the short guide on how to do it.

Our own Wiki article

First, let’s create a new project for the Wiki. Thanks to this, you can choose who will have access to it, and who could edit or add new pages. Also, all your article will be in one place, where you will have easy access to them.

Now create a blank page, without any predefined formats. This way we will have full freedom of how we want to format our Wiki pages.

Write down all the information you want to share with your current and future colleagues from the company. If this is the first time, you are creating such a page, don’t think about formatting just yet. For now, the text itself should be the focus. Remember, that encyclopedia articles should centre just on the information. Share your knowledge from the objective side, without any personal comments. Just get to the point. People who will read this article will search only for one or two most important sentences, that they need for their project. Make their job easier by writing this page accordingly to their needs.

Headings as a shortcuts

Ok, now we have content, but it doesn’t look very clear. It’s time to do some formatting.

The most important thing to do right now is to mark down all the heading in the text. This will make it more readable from the get-go. Headings will also help Confluence itself to understand how this page is constructed. Why is this needed? We will get back to it in the second. Every page needs a title, and every part of the text on the same topic needs a heading. You gave 6 different ones to use. Usually, ones with lower numbers are used for the bigger or more important parts of the article.

Table of Contents

Ok, but what was the other reason for the headings? Thanks to them, Confluence can create for you automatically the Table of Contents. You can find it in the “Insert more content” part of the toolbar, under the plus “+” sign. This is an incredibly powerful tool. Everyone who will see your article, from the start will know where to go. Finding easily interesting him or her information.

Table of Contents not only shows the list of all the headings but also creates the hyperlinks to them. If you want to move to the specific part of the article, you can just click it. Confluence will take you where you want to. After inserting the Table of Contents in the edit menu you will see only the small box. Don’t worry, this is only for the edit mode. After saving your file, your readers will see the full menu for your article.

Under the “Insert more content” you will find also the horizontal rule. Thanks to this, you can divide your text not only thematically, but also visually. This little accent will make your article much more friendly to use for all of the readers, interested in the topic.

Connect your knowledge

Now you have links to the parts of the article itself, but what if you want to create a link in your article to other ones, that you have created? Once again click the “Insert more content” button in the toolbar. Right there, you can find the “link” button. After pressing it, Confluence will allow you to link to only to the other articles you’ve created, but also to the internet websites or files. Remember to add as many relevant links in your wiki article, as it is possible. This allows your readers to jump quickly between pages interesting to them. Without wasting time in the search bars.

Sometimes you want for some part of a text to really stand-up from the rest. Usually for the most important information on the page. This is when the “Info” content could be a very useful tool for you. Confluence will create an info-box, that will bring the reader’s attention to itself. Remember to not to overuse it. All the content on the wiki page has to be very clear, so insert the infobox only for the key part of the article.

Visual aid for a Wiki

Of course, just like in any other types of document, you can add the images. Too many of them could make the whole page unreadable, but if you add only two or three of them, they can help your readers to imagine the point of the whole article for themselves. Images also don’t have to be photos. Graph or technical drawing usually can help explain the process you want to present to the others.

Finally, you can also add the status bar. Thanks to it, you can clearly communicate for the others, if the part of the article is completed, needs more editing or has to be deleted. Working in Confluence is usually a cooperative job. When you create something, be sure, that others, that will use this page, will know, what information is full, and what else needs to be researched.

There are many useful add-ons for Atlassian tools that can save you time and make your work more efficient. We can mention here tools made by our parent company like Worklogs or Multiple Checklists . If you are a non-profit organization, you can get them without any charge, for free.

Maciej Neumann

Explore more categories


Email marketing: How to write cold emails?


Why Is My Website So Slow? Website Speed Optimization

Do you want to boost your business, drop us a line and keep in touch.

how to create a wiki page on confluence

NIP 5862322520

Privacy overview.


  1. Confluence for beginners: the complete guide

    how to create a wiki page on confluence

  2. How To Create Knowledge Base In Confluence

    how to create a wiki page on confluence

  3. How to build a release planning page in Confluence

    how to create a wiki page on confluence

  4. How to make your Confluence pages more attractive

    how to create a wiki page on confluence

  5. Confluence

    how to create a wiki page on confluence

  6. Confluence 101: the 5 things I wish I knew sooner about creating pages

    how to create a wiki page on confluence


  1. Karma Basic Tutorial: Section, Row & Column

  2. Yoikee Creator: How to Use (Confluence Add-on)

  3. Tutorial: How To Interact With Confluence Pages

  4. How to Create Wikipedia Account || How to Make a Wikipedia Page || How to Create Wikipedia Profile

  5. Karma Basic Tutorial: How to Insert Karma

  6. Karma Basic Tutorial: Editor Basics


  1. how to create a wiki page in confluence?

    To create a page I recommend you to read this: Create and Edit Pages. For beginners, I would recommend you to read some tutorials to get startet, like this documentation: Get started If you have any other specific question, don't hesitate and ask. Regards Dominic Reply Suggest an answer Log in or Sign up to answer Still have a question?

  2. How to create a wiki page in Confluence?

    Confluence is a wiki, all the pages are wiki pages. But it looks like you are thinking about wiki markup - that is no longer used by Confluence, although the editor does accept it as shortcuts (it understands it and transforms it into the storage format it now uses)

  3. How to create a Confluence wiki for your company

    Steps for success when building your Confluence wiki 1. Define your business requirements Start by asking what business problem you want to solve. Is your aim to create a streamlined internal hub where colleagues receive general company updates? Or is your requirement more function-specific?

  4. Create a Confluence Site and Your First Wiki Pages

    There are a few steps to creating a wiki with Confluence: 1. Create an account on Confluence using this link. 2. Make sure to write down your password somewhere secure. You'll get an email with a link to confirm. 3. Start a Confluence trial using this using this link. A screenshot of the Confluence sign-up 4. Choose a site name.

  5. How do I create a new page in my Confluence wiki?

    Enter content for your page using Confluence Notation, or the Rich Text editor. Preview if desired. Click Add. In Confluence, you can create links to pages that you intend to create at a later point. This type of a link is an undefined link and is indicated with a plus sign. Clicking on the link brings up the 'Add Page' screen.

  6. Confluence wiki markup syntax

    To insert markdown in the Legacy editor: Choose Insert > Markup . Select Markdown . Type or paste your text - the preview will show you how it will appear on your page. Choose Insert. As with wiki markup, Confluence Cloud will convert your markdown to the rich text editor format. You will not be able to edit your content using markdown. Headings

  7. Confluence: The Ultimate Wiki Software

    Get feedback and stay in sync with every team in one place. Easily communicate, share information, and tackle projects together with clear and open documentation. Collaborate on and edit pages together in real time. Keep conversations going with inline comments and likes. Break down silos across teams with live activity feeds.

  8. Create and Edit Pages

    Confluence header: create blank pages, pages from templates and visit spaces or your profile. Space sidebar: access pages, blogs and administer the space. Page tools: edit or share the page, watch it to get updates and perform more actions. Another useful way to create a page is to use the Create from Template Macro.

  9. Solved: How to create folders in confluence like we can cr

    Confluence is a wiki, not a document store like Google Drive. As such, "folders" make no sense to it. The focus is on pages, for which you can create a "tree", but each page simply holds attachments, there's no real use for attachment directories under pges. Rajul Jain Jul 01, 2021 Thanks for reply, but yet my problem is not solved.

  10. how to insert pagebreak into confluence wiki page

    Go to Confluence Admin -> User Macros -> Create a user macro Give a macro name (ex: pagebreak), category, etc. Select "No Macro Body" Add the line below to "Template" ## @noparams <div style="page-break-before:always;"></div> Than, user this macro in page content where you want add a page break for export. Solution 2: Add a "Div" macro

  11. Create, edit, and publish a page

    You can create a page from anywhere in Confluence—just select Create in the navigation, and you're ready to go. If you like, you can select a template from the panel on the right so you don't have to start from scratch. For more information about using templates, see Create a page from a template.

  12. Solved: Import Wiki-Pages to Confluence

    If you can export the content and have someone who can do some programming you can always use the Confluence API to create pages. Reply 0 votes Nithin C N Dec 14, 2022 Hi Victor, We have Wiki migration tool Confluence. Please let me know if you still have requirements.

  13. Create engaging Confluence pages in 4 easy steps

    To determine the layout of your Confluence page: Press the "Page layout" button on the toolbar, or type "/layouts" Adjust the number and proportions of columns If you want, you can also expand the width of each section to full or medium width Tip

  14. How to Set Up an Atlassian Confluence Wiki for your Company

    Here at AccessAlly, we use a Confluence Wiki for our company operations, systems, and processes. In this tutorial, you'll see how to set up and organize a co...

  15. Confluence Tutorial #5

    51K views 2 years ago CONFLUENCE TUTORIAL - Complete course for beginners and intermediate users Get all my courses for USD 5.99/Month - In this...

  16. Confluence Wiki Markup

    Wiki markup is useful when you want to do one of the following: Type wiki markup directly into the editor. Confluence will convert it to the rich text editor format as you type. Create links using the Advanced tab of the Links Browser. Add custom content to the sidebar, header or footer of a space.

  17. Create a new page

    Step 1. Determine if you are creating a Resource, How-To, or Policies and Procedures-related page and go to that section of the wiki by selecting the appropriate link from the Page Tree on the left-hand navigation on the page. This page will be a How To / Support page so I will start by going here. If you are not already logged in, make sure to ...

  18. Create or edit a wiki page

    Edit a page. To see a list of all your wiki pages, click the link with your repository's name under the Wiki heading. Click the wiki page that you want to update. Click Edit in the top right. After making your changes to the page content, enter a comment in the Message text box. This comment appears as a commit message and as part of the page ...

  19. Adding and Arranging Pages within a Confluence Space

    Within that space pages are organized into a tree, where child pages are attached to parent pages, and the space home page is the ultimate parent page. To create a child page of any page in the wiki, go to that page and click the yellow Create button in the top bar: The wiki automatically opens a page editor for your new page.

  20. Set Up Your Confluence Site and Spaces

    Step 2: Create a space. Once you know what kinds of spaces your organization will need, it's time to create your first space. Go to your Confluence site. From the home screen, select Create Space. Select the type of space you'd like to create. Fill in the Space name, Space key, and other details.

  21. JIRA Tutorial for NGOs. Part 5

    Thanks to Confluence we can create our own, first simple version of Wiki-style article. Just for the eyes of the people of the company. Here is the short guide on how to do it. Our own Wiki article. First, let's create a new project for the Wiki. Thanks to this, you can choose who will have access to it, and who could edit or add new pages.