Ask or search…
Comment on page

Code blocks

Add a code block to a page
You can show code on GitBook using code blocks. You can choose to set the syntax, show line numbers, show a caption, and wrap the lines. There is also a convenient way to copy the contents of a code block to the clipboard.
A code block may be useful for:
  • Sharing configuration
  • Code snippets
  • Code files
  • Showing usage examples of command line utilities
  • Showing how to call API endpoints
  • and for many more scenarios...

Example of a code block

import * as React from 'react';
import ReactDOM from 'react-dom';
import App from './App';
ReactDOM.render(<App />, window.document.getElementById('root'));
You can also combine code blocks with the tabs content block to offer the same example in multiple languages:
let greeting = function (name) {
console.log(`Hello, ${name}!`);
greeting = lambda {|name| puts "Hello, #{name}!"}
greeting = fn name -> IO.puts("Hello, #{name}!") end
You can now convert code blocks to full width by clicking on the
Block handle
next to the block. Read more about full-width blocks.


Set syntax

You can set the syntax to any of the supported languages and that will enable syntax highlighting in that language.
We use Prism for syntax highlighting. Here’s an easy way to check which languages Prism supports: Test Drive Prism. If you notice a mismatch between GitBook and Prism, there’s a chance we are a version or two behind. We’ll catch up soon!

With line numbers

Toggle showing line numbers. Showing line numbers is useful when the code represents the contents of a file as a whole and it makes sense to have them shown. Hiding line numbers is useful for snippets, usage instructions for command line or terminal expressions and similar scenarios.

With caption

A code block can have a caption. The caption is often the name of a file as shown in our example, but it can be used as a title, or anything else you’d like.

Wrap code

Depending on what the code snippet represents you may or may not want to wrap lines. Wrapping lines is useful when your code is long and you want to avoid having the viewer scroll back and forth to read it. Wrapping often goes well with showing line numbers as that makes it easier to read the code and understand where each new line starts.


Copying the code

You can hover over a code block and see an icon that allows you to copy the contents of the code block to the clipboard in one click:
Screenshot showing the icon in a code block that allows you to copy its contents to the clipboard.
Copy code block contents to the clipboard

Representation in Markdown

{% code title="index.js" overflow="wrap" lineNumbers="true" %}
‌import * as React from 'react';
import ReactDOM from 'react-dom';
import App from './App';
ReactDOM.render(<App />, window.document.getElementById('root'));
{% endcode %}
Last modified 2d ago