Add formatting to your page

You can add emphasis to your text with formatting such as italics, bold, underline—even color and alignment. 

In addition to your standard formatting options, like bold and italics, you can also change page layouts in Confluence, add dynamic tables of contents, add and assign tasks, and display images, gifs, videos, and other multimedia. 

Pages in your site may use the new editor or the legacy editor. This page explains how to use both editors.

Use these links to jump to the section detailing the editor you use.


Which editor does your page use

When you edit a page, you can look over the toolbar for visual indicators, like the differences between the text color pickers or the inclusion of an emoji icon in the new editor toolbar. You'll also notice that the Publish and Close buttons were moved to the top right in the new editor.

New editor

Legacy editor

New Editor

This section provides the following details for creating, editing, and publishing content using the new editor.

Text

Confluence has all the standard formatting options you'd see in other document editors. You can add emphasis to your text with formatting such as italics, bold, underline—even color and alignment. 

To indent, use your tab key; to outdent, use your shift + tab key combination. These keyboard actions work for blocks of text or for bulleted and numbered lists.



Here are some other formatting tools you can use:

  • Quotes - Emphasize a quote by clicking Insert from the toolbar and selecting Quote, or type /quote and type the text to be quoted

  • Divider - Separate sections of text using the horizontal line divider. You can find this under the Insert menu.

  • Dates - Insert a date by typing // and picking your date.

  • Mention - Use @ and a person’s name. The user mentioned receives a notification, so you can use this to let them know to read the page, or to draw their attention to a specific comment.

  • Wrap text - Let text flow around your images by selecting an image and clicking Wrap left or Wrap right from the floating toolbar.

  • Code - Use the code snippet element that is inserted by typing /code to access the list of elements.
  • Expands - Is there amount of info on the page overwhelming at first glance. If you want a page to display extra info for the people who need it, without cluttering it up for everyone else, click the Insert menu and select the Expand element.

  • Draw attention to content - Insert an Info panel. This creates a colored box surrounding your text with the ability to choose an icon with a specific background color.
  • Action items - Add action items by using the Action items button in the toolbar and mentioning another user. Whoever you first mention on that line is assigned the action item. Assigning someone an action item looks like this: 



    Items like this show up on Dan Morgan’s tasks list under his profile, and he can tick them off as he does them. The due dates turn red if they become overdue. He can also filter them by date, completion, and whether they were assigned to him or created by him from here. If he'd prefer to see these on another page, he can also use the Task Report Macro.

  • Page headings - Use the Table of Contents Macro to generate a list of links pointing to the headings on the page. The list of links appears wherever you add the macro, and automatically updates each time someone changes the wording of a heading.

  • Visual appeal - Use emojis. See the full list of here.

To insert a link on a page:

  1. Select some text, or position your cursor where you want to insert the link.

  2. Choose Link on the toolbar.  You can also use keyboard shortcuts - Ctrl+K on Windows and command+K on Mac.

  3. Select a page, blog post, or enter an external URL (see Links and Anchors for how to link to particular types of content).

  4. Enter or modify the link text. This is the text that will appear on the page. If this field is left blank, the page name or URL will be used as the link text.

  5. Press Enter.

You can also paste a URL directly onto your page. Confluence automatically creates the link, and if the URL is from a page on the current site, the page name will be set as the link text.

Images, videos, and gifs

If a photo is worth a thousand words, how many words is a gif worth?



Add an image or gif onto a Confluence page by choosing the Files & images button on the toolbar. Either upload your image or gif into Confluence, or display an image from another web page using its URL.  You can select the pixel size of your images, or choose original so that it fits to scale. If your image is too big for the column or page, it'll result in a horizontal scroll.

tip/resting Created with Sketch.

Drag files, like images, multimedia, Office files and PDFs, from your computer and drop them directly into the editor. The contents of the file will be embedded into the page or blog post.

Annotate images

After inserting an image, you can access annotation tools from the image's floating toolbar.

You can insert the following embellishments and control their color and thickness:

  • Arrows
  • Text
  • Rectangles, ovals, and lines
  • Brush strokes
  • Blur a certain area

Multimedia

You can also display movies, animations and videos, and embed audio files on your Confluence page. Confluence supports Adobe Flash, MP3, MP4, and various other movie formats. Upload these using the multimedia macro

Social video and image sharing 

The Widget connector macro displays live content from YouTube, Vimeo, Flickr, and other sites. For Youtube and Vimeo links, you can paste the URL onto your page, and it will automatically convert into a playable video. 

Browse through the full list of macros to see what other cool things, from statuses to roadmaps, you can add to your Confluence page. 

Images and files occupy their own line in the new editor. It’s not possible to add an image within the flow of text. If an image is small enough, like a product icon, you can create a custom emoji and insert an image like that.

Tables

To add a table, choose Insert table in the toolbar, then a three-column, three-row table appears on the page. Table widths are determined by you. The width selector to the right of the table lets you switch between fixed-width, wide, and full-width.

All of the options needed to modify that table are found in the floating toolbar under it. The choices made in that toolbar are specific to the table in focus. When you click on a different table, you see the options for that table.

Edit your table

The table editing tools are contextual and vary based on where you place your focus

Here's a summary of the table tools and how to use them.

Table options








  • Mark a row as a header row with a grey (shaded background and bold text)
  • Mark a column as a header column with a grey (shaded background and bold text)

  • Insert a numbering column to automatically number each row

  • Remove a table by clicking the trashcan icon

Copy table

Once you have a table with the right features, you can copy and paste the table.


Rows

  • Insert a row - With focus on the table, click a dot on the left to insert a row below it

  • Delete a row - With focus on a row, hover over the leftmost edge, and highlight the row to access the ability to delete it

Columns

  • Insert a column - With focus on the table, click a dot on the top to insert a column to the right

  • Delete a column - With focus on a column, hover over the topmost edge, and highlight the column to access the ability to delete it

Cells












With focus in a cell, click the down arrow to access the following actions:

  • Change cell color

  • Insert column to the right

  • Insert row below

  • Remove column

  • Remove row

  • Clear cell

When multiple cells are selected, the option to merge cells is available

If a cell was previously merged, you have the option to split the cell


When viewing a table on a page, you can sort it by clicking the sort icons in the header row. Your sorting choices don’t impact what other people see.


Tables don't nest; that is, you can't have a table within a list, block quotes, or another table.
tip/resting Created with Sketch.

Very wide tables

The width of each column is set to a percentage of the page width, so your columns will grow or shrink as your page size changes. Using the width switcher to the right of the layout, you can determine how much white space appears on either side of your layout. If a column includes an item that's too wide for it, you'll see a horizontal scroll bar when viewing the page.


Layouts

The layout of your pages can have a big influence on how they're read, and what visual impact your content has. Narrower columns, for example, optimize for readability, with around 50-75 characters per line, but wider page widths work better for displaying tabular data.

You can create different layouts in Confluence after inserting a default layout using the Layouts tool, giving different parts of your page a different column configuration. 


There are several column layouts available. After inserting a layout, you can easily switch between the options. Content doesn't get lost when you change the column layout; additional columns are added to the right, and when you change to a layout with fewer columns, the content moves to the left. 


Legacy editor

This section provides the details for adding formatting to your page using the legacy editor.

Click here to expand...

Layouts

The layout of your pages can have a big influence on how they're read, and what visual impact your content has. Narrower columns, for example, optimize for readability, with around 50-75 characters per line, but wider page widths work better for displaying tabular data.

You can create different layouts in Confluence with the section tool, giving each section a different column configuration. 

Screenshot: Editor view of a page showing two sections with different column configurations. 


To use sections, choose the Page Layout   button in the toolbar. This will cause the Page Layout toolbar to appear.

1. Add a section: Adds a new section below your current content, with the boundaries of the section(s) indicated by dotted lines (the dotted lines aren't visible when you view the page).

2. Column layouts: Changes the column layout of the section in which you have your cursor. Content doesn't get lost when you change the column layout; additional columns are added to the right, and when you change to a layout with fewer columns, the content moves to the left. 

3. Move a section: Moves the section you have your cursor in, along with all the content in it, above or below other sections on the page. 

4. Remove section: Removes the section you had your cursor in, deleting that section and all of its contents.

Very wide tables:

The width of each column is set to a percentage of the page width, so your columns will grow or shrink as your page size changes. If a column includes an item that's too wide for it, you'll see a horizontal scroll bar when viewing the page. If you want to avoid this, set your images to original size, which scales them to fit. 


Text

Confluence has all the standard formatting options you'd see in any other word processing software. Play around with italics, bold, and underline to add emphasis to your text, or change the color, indentation, or alignment. In addition to those, here are some other formatting tools you can use:

  • Emphasize a quote by changing the style of that text from paragraph to quote.

Quotes look like this.

  • Separate sections of text using the horizontal line divider. You can find this under the  insert more menu



  • Use the date picker by typing //and picking your date.

  • Mention someone by using @ and their name. This will look like this: Desiree Conceicao. The user you mention will receive a notification, so you can use this to let them know to read the page, or to draw their attention to a specific comment.

  • Wrap text around your images by selecting an image, and clicking any of the align buttons twice. The first time will change the alignment, and the second time will cause the text to wrap around the image. 

  • Use the code block macro to display source code in your page with syntax highlighting.

<div style="color: green">
	<p> This page needs more cats.</p>
</div>


  • Too much info? If you want a page to display extra info for the people who need it, without cluttering it up for everyone else, try using expands.
Click here to expand...

You can find expands under the macro browser. Go to the insert more menu > other macros > expands.


  • Call attention to information using info, tip, warning, or note macros. These create a colored box surrounding your text. 


  • Alternatively, use a panel macro. You can change the border, title, and background of the panel for a variety of looks. 
  • Add tasks by using the  button and mentioning another user. Whoever you first mention on that line is assigned the task. Assigning someone a task looks like this: 
    These tasks will show up on Giles Brunning's tasks list under his profile, and he can tick them off as he does them. The due dates will turn red if they become overdue. He can also filter them by date, completion, and whether they were assigned to him or created by him from here. If he'd prefer to see these on another page, he can also use the Task Report Macro.
  • Use the Table of Contents Macro to generate a list of links pointing to the headings on the page. The list of links will appear wherever you add the macro, and will automatically update each time someone changes the wording of a heading.
  • Add emojis, symbols, or special characters. (awesome)(star). See the full list of here

Tables

To add a table, choose  Insert table in the toolbar, then click a cell in the drop-down to set the number of columns and rows. 

Edit your table

To make changes to your table, click inside any of the cells. This will cause the table tools to appear in the toolbar. 

Here's a summary of the table tools:

Column width modes

  • Responsive – The table will expand as you add content, and you can drag to resize the columns. It'll also resize itself to fit the page-viewer's window size (within reason).
  • Fixed width – Drag column borders to set width. Columns appear at your set size, regardless of content and window size.

Rows

  • Insert rows before or after the current row, or delete the current row
  • Cut, copy, and paste the current row
  • Mark a row as a header row (shaded with bold text); double click this to remove the header row.

Columns

  • Insert columns before or after the current column, or delete the current column
  • Cut, copy, and paste the current column
  • Mark a column as a header column (shaded with bold text); double click this to remove the header row

Cells

  • Merge selected cells or split selected cells
  • Change cell color

Table

  • Remove a table
  • Insert a numbering column to automatically number each row


When viewing a table on a page, you can sort it by clicking the sort icons in the header row.

(info) Tables do not nest; that is, you cannot have a table within a list, block quotes, or another table.

To insert a link on a page:

  1. Select some text or an image, or position your cursor where you want to insert the link.
  2. Choose Link on the toolbar or use the keyboard shortcut Ctrl+K.
  3. Select a page, blog post or attachment, or enter an external URL (see Links and Anchors for how to link to particular types of content).
  4. Enter or modify the link text. This is the text that will appear on the page. If this field is left blank, the page name or URL will be used as the link text.
  5. Choose Insert.

You can also paste a URL directly onto your page. Confluence will automatically create the link, and if the URL is from a page on the current site, the page name will be set as the link text.

Images, videos, and gifs

If a photo is worth a thousand words, how many words is a gif worth?

Add an image or gif onto a Confluence page by choosingFiles and Images. Either upload your image or gif into Confluence, or display an image from another web page using its URL.  You can select the pixel size of your images, or choose original so that it fits to scale. If your image is too big for the column or page, it'll result in a horizontal scroll. 

Drag and drop:

Drag files, like images, multimedia, Office files and PDFs, from your computer and drop them directly into the editor. The contents of the file will be embedded into the page or blog post.

Multimedia

You can also display movies, animations and videos, and embed audio files on your Confluence page. Confluence supports Adobe Flash, MP3, MP4, and various other movie formats. Upload these using the multimedia macro

Social video and image sharing 

The Widget connector macro displays live content from YouTube, Vimeo, Flickr, and other sites. For Youtube and Vimeo links, you can paste the URL onto your page, and it will automatically convert into a playable video. 

Browse through the full list of macros to see what other cool things, from statuses to roadmaps, you can add to your Confluence page. 


Last modified on Feb 11, 2020

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.