Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
November 8, 2020 02:59
May 13, 2020 15:03
May 13, 2020 15:03
November 14, 2019 01:57
May 13, 2020 15:03
May 13, 2020 15:03
May 13, 2020 15:03
January 6, 2021 21:13
July 25, 2021 07:41
May 13, 2020 15:03

Github Release Minimum DokuWiki Version
Become a sponsor Donate Paypal


This plugin is an alternative to GeSHi server-side code highlighting of DokuWiki with client-side SyntaxHighlighter by Alex Gorbatchev.

The subfolder syntaxhighlighter4/dist contains a build of SyntaxHighlighter 4.x.

For compatibility and conflicts with others plugins, please refer to the official DokuWiki SyntaxHighlighter4 plugin page.

Download and Installation

Download and install the plugin using the Plugin Manager using the download link given above. Refer to Plugins on how to install plugins manually.

If you install this plugin manually, make sure it is installed in lib/plugins/syntaxhighlighter4/. If the folder is called different it will not work!

Syntax and Usage

<sxh [brush][; options]>
... code/text ...


The brush (language) that SyntaxHighlighter should use. Defaults to "text" if none is provided.
See the section brushes and themes for a complete list of available brushes.


Semicolon separated options for SyntaxHighlighter, see SyntaxHighlighter Configuration.
The plugin handles the Block Title from SyntaxHighlighter 3 as an option, i.e. title: <title string>;.


Syntaxhighlighter default options can be overrided via the Config Manager :

  • autoLinks: Allows you to turn detection of links in the highlighted element on and off. If the option is turned off, URLs won’t be clickable (default true)
  • firstLine: Allows you to change the first (starting) line number (default 1)
  • gutter: Allows you to turn gutter with line numbers (default true)
  • htmlScript: Allows you to highlight a mixture of HTML/XML code and a script which is very common in web development. Setting this value to true requires that you have shBrushXml.js loaded and that the brush you are using supports this feature (default false)
  • smartTabs: Allows you to turn smart tabs feature on and off (default true)
  • tabSize: Allows you to adjust tab size (default 4)
  • override: List of tags to override


<sxh php; first-line: 89; highlight: [106,107]; title: New title attribute in action>
     * Render xhtml output or metadata
     * @param string         $mode      Renderer mode (supported modes: xhtml)
     * @param Doku_Renderer  $renderer  The renderer
     * @param array          $data      The data from the handler() function
     * @return bool If rendering was successful.
    public function render($mode, Doku_Renderer &$renderer, $data) {
        if($mode != 'xhtml') return false;

        if (count($data) != 3) {
            return true;

        list($syntax, $attr, $content) = $data;
        if ($syntax == 'sxh') {
            $title = $this->procTitle($attr);
            $highlight = $this->procHighlight($attr);
            $renderer->doc .= '<pre class="brush: ' . strtolower($attr . $highlight) . '"' . $title . '>' . $renderer->_xmlEntities($content) . '</pre>';
        } else {

        return true;

Expected result:


Copy to clipboard

Double click anywhere inside SyntaxHighlighter code area to highlight the text and then copy it using Ctrl/Cmd+C or mouse right click > Copy.
Click outside the code area to restore highlighting.

Highlight a range of lines


<sxh php; highlight: [11-15]>
     * [Custom event handler which performs action]
     * @param Doku_Event $event  event object by reference
     * @param mixed      $param  [the parameters passed as fifth argument to register_hook() when this
     *                           handler was registered]
     * @return void

    public function handle_metaheader(Doku_Event &$event, $param) {
        // Add SyntaxHighlighter theme.
        $event->data['link'][] = array('rel' => 'stylesheet',
            'type' => 'text/css',
            'href' => DOKU_BASE . 'lib/plugins/syntaxhighlighter4/dist/'.$this->getConf('theme'),

        // Register SyntaxHighlighter javascript.
        $event->data["script"][] = array("type" => "text/javascript",
            "src" => DOKU_BASE . "lib/plugins/syntaxhighlighter4/dist/syntaxhighlighter.js",
            "_data" => ""

Expected result:

List of brushes and themes

  • Official brushes
    • applescript
    • as3
    • base
    • bash
    • coldfusion
    • cpp
    • csharp
    • css
    • delphi
    • diff
    • erlang
    • groovy
    • haxe
    • java
    • javafx
    • javascript
    • perl
    • php
    • plain
    • powershell
    • python
    • ruby
    • sass
    • scala
    • sql
    • swift
    • tap
    • typescript
    • vb
    • xml
  • Custom brushes
    • halcon
    • IEC61131
    • kotlin
    • latex
    • Makefile
    • mel
    • objective-c
    • yaml
  • Official themes
    • default
    • django
    • eclipse
    • emacs
    • fadetogrey
    • mdultra
    • midnight
    • rdark
    • swift
  • Custom themes

How can I help ?

All kinds of contributions are welcome πŸ™Œ! The most basic way to show your support is to star 🌟 the project, or to raise issues πŸ’¬ You can also support this project by becoming a sponsor on GitHub πŸ‘ or by making a Paypal donation to ensure this journey continues indefinitely! πŸš€

Thanks again for your support, it is much appreciated! πŸ™


GPLv2. See LICENSE for more details.
Icon credit to Snip Master.