Adding code blocks

Document360 uses Prism.js for syntax highlighting and supports various programming languages in code blocks, including:

• HTML

• C#

• Java

• JavaScript

• XML

• JSON

• CSS

• SQL

• Python

• Markdown

• PHP

• PowerShell

• Text

For an exhaustive list of languages that are supported, please refer to the documentation for Prism's Supported languages.

Creating code blocks in the Markdown editor

In the Markdown editor, there are two methods to create fenced code blocks:

1. Use triple backticks ``` before and after the code snippet.

For example:

```csharp
[your code snippet]
```

2. Use the shortcut Ctrl+Shift+P or click the Insert codeblock () icon from the formatting toolbar.

Creating code blocks in the WYSIWYG (HTML) editor

To create code blocks in the WYSIWYG (HTML) editor, follow the steps below:

1. Navigate to the desired article in the WYSIWYG editor.

2. Click the Code block () icon, and a panel will appear.

3. Select your desired language from the dropdown menu.

4. Enter your code into the Insert your code field.

5. Click Insert to add the code block to your article.

6. Click the Edit () icon on the right side to edit a code block.

7. Click the Delete () icon on the right side to delete a code block.

Creating code blocks in the Advanced WYSIWYG editor

To create a code block in the Advanced WYSIWYG editor, follow the steps below:

1. Navigate to the desired article in the Advanced WYSIWYG editor.

2. You can create code blocks in three ways:

   1. Click the Code block () icon in the Quick insert menu. The Quick insert menu will appear only when the block is empty.

   2. Enter three backticks ``` and press Enter.

   3. Use the slash command /code block and press Enter.

3. Click on the created code block. A floating menu will appear.

4. Select the desired heading.

5. Click the Copy () icon to copy the code.

6. Click the Delete () icon to delete the code block.

7. Enter the indented code inside the code block.

Language shortcodes

• C: c

• C++: CPP, c++

• C#: csharp

• CSS: css

• CoffeeScript: coffeescript

• HTML: html

• JSON: json

• Java: java

• JavaScript: javascript, js

• Objective-C: objective-c, obj-c, objc

• Objective-C++: objc++

• PHP: php

• Perl: perl, pl

• Python 3: python3, py3

• Python: python, py

• Ruby: ruby, rb

• Snobol: snobol

• XML: xml

Custom language

If the desired language is unavailable, you can create a Custom Language code block.

1. In the Markdown editor: After inserting the code block, add a title by entering the desired text after the initial backticks:

```HTML
Hello world
```

2. In the WYSIWYG editor: Select Custom from the Select Language dropdown and enter your desired title in the Enter your title field.

3. In the Advanced WYSIWYG editor: Use the search bar in the dropdown to select Custom, then click the Edit () icon to enter your title and click Update.

Indentation and code blocks

Any text indented by at least four spaces will be treated as a code block. This method is useful for longer code snippets, but it will not include syntax highlighting.

The following code block is created using indents instead of backticks.

def test():
    logging.error('Test failed')

Code block examples

The following code blocks are created in various programming languages, including C#, JavaScript, XML, JSON, PowerShell, and Ruby, to dynamically showcase syntax and functionality.

using System;
namespace HelloWorld
{
    class Hello 
    {
        static void Main() 
        {
            Console.WriteLine("Hello World!");

            // Keep the console panel open in debug mode.
            Console.WriteLine("Press any key to exit.");
            Console.ReadKey();
        }
    }
}

function $initHighlight(block, cls) {
try {
if (cls.search(/\bno\-highlight\b/) != -1)
return process(block, true, 0x0F) +
` class="${cls}"`;
} catch (e) {
/* handle exception */
} 
export $initHighlight;

<book id="bk101">
      <author>Gambardella, Matthew</author>
      <title>XML Developer's Guide</title>
      <genre>Computer</genre>
      <price>44.95</price>
      <publish_date>2000-10-01</publish_date>
      <description>An in-depth look at creating applications 
      with XML.</description>
   </book>

{
    "one": 2,
    "three": {
        "point_1": "point_2",
        "point_3": 3.4
    },
    "list": [
        "one",
        "two",
        "three"
    ]
}

$user = Read-Host "Enter Username"
$pass = Read-Host "Enter Password" -AsSecureString

require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html