Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Secure - All data and code is stored and processed on Atlassian servers so extra security risk

  • Syntax highlighting for over 300 languages, including Gherkin

  • One button to copy the code

  • Multiple themes to choose from to suit the page style or use different themes for different languages

  • Line highlighting to shows which bits of code are important

  • Macro can be configured to start collapsed so it does not make the document too long

  • Customizable title for each macro so you can let people know what the code is

  • Focus lines so you by default the Macro only shows a subset of lines but can be expanded

  • Configurable line numbers so you can choose to show them only when they are useful

Table of Contents
minLevel1
maxLevel2
outlinefalse
stylenone
typelist
printabletrue

Basic Usage

Edit a page or Create a new page and type /better click on the Better Code Block option when it appears.

...

To choose a language, simply click on the Language dropdown and either scroll to find your language or start typing and the list will be filtered so you can then easily select your language.

download (56).pngImage Added

Themes

Better Code Block comes with eight themes, simply select one from the dropdown, some examples are shown below

download (57).pngImage Added

Default

We don't have a way to export this macro.

...

We don't have a way to export this macro.

Line Highlighting

You can configure the Code Block to highlight certain lines to make them stand out. These are specified as groups separated by commas, each group can either by a single line number or a start and end range of lines separated by a hyphen -.

e.g. the below code has 1,3-4 set in the Lines to Highlight field

We don't have a way to export this macro.

linehigh.pngImage Added

Auto Collapse

Long pieces of code can make clutter up a page and make it difficult to scroll. If you set Start collapsed with just title showing to Yes then only the title will be shown by default as below but you will still be able to easily open up the code when it is relevant to you.

We don't have a way to export this macro.

...

Custom Title

Focus Lines

Configurable Line Numbers

...