Plugin Overview

The Source Editor for Confluence allows the user to edit Confluence page XHTML using a browser-based editor.

It has a plethora of features:

  • Syntax highlighting

  • Code/tag folding

  • Find/replace with regex support

  • Page preview

  • Markup validation prior to submit

Accessing The Source Editor

To open the source editor, click the </> button conveniently located in the upper-right corner of any editable page. 

You must be logged in and have editing privileges in order to edit the Confluence page source.

Editing Confluence Source

The source editor provides direct access to Confluence page source. Confluence pages are stored in an XML-based format called Confluence Storage Format.

Confluence Storage Format is a subset of HTML. It does not support all features of HTML. Please see here for more details.

Code Editing

The source editor is designed to be lightweight but contains a set of features that allows easy and intuitive editing of a Confluence page source. The following are the available editing options:

  • Automatic indentation and syntax highlighting are available and enabled. 

  • Preview: Click this button to view a preview of the Confluence page as it will be rendered. Most macros are not rendered and <script> tags are disabled during page preview.

  • Code folding: Use the markers next to the line numbers to fold XHTML tags.

  • Beautify: Use this button to make your code more readable.

  • Wrap text: Use this button to wrap the long code into the next line.

  • Find/Replace: Use this button to easily search for and replace code in the editor or use the Regex button to allow a regex string input.

The following features are available in the Find/Replace option:

Every feature in the above image is marked with a number to help you identify it. The following table describes the features:

Number

Parameter

Description

1

Match Case

Click this button to start a case-sensitive word search.

2

Match Whole Word

Click this button to start a search to find for the exact match. This is not a case-sensitive search option.

3

Use Regular Expressions

Click this button to use regular expressions for the search.

4

Previous match

Click the up arrow button to highlight the previous match.

5

Next match

Click the down arrow button to highlight the next identified match.

6

Find in selection

Click this button to highlight all identified matches.

7

Close

Click this button to close the Find/Replace window.

8

Preserve Case

Click this button to replace the identified word with the same case as that of the searched text.

9

Replace

Click this button to go over each word and replace it.

10

Replace All

Click this button to replace all identified words at a time.

11

Find

Enter the text you want to search.

12

Replace

Enter the text you want to replace with.

Source Validation

In order to save any edits made to a Confluence page, the XHTML source must be valid. To confirm the validity of your source, simply click Submit and the editor will perform the verification. If your source is valid, the page will be saved. If your source contains an error, a message will be displayed indicating the nature of the error and the location in the code where it was discovered.