Decap widgets convert Hugo shortcodes into decap compatible widgets so you can insert them into your markdown files via the decap editor.

Audio Widget

The Audio widget has 6 properties, these are:

  • src: required string - the url pointing to the source file
  • title: optional string - a title for the audio clip, otherwise the filename is used
  • span: required number - [1–6] width of the shortcode
  • autoplay: optional boolean - if true, the audio clip plays without interaction defaults to false
  • muted: optional boolean - if true, the audio file will be muted default to false
  • loop: optional boolean - if true, the audio clip plays repeatedly defaults to false
HTML Example

6-second synth melody

Decap Usage

Bullet Widget

The Bullet widget has 3 properties, these are:

  • type: required boolean - can be of type true or false
  • leading_text: optional string - the text to display at the beginning of the text, displays in bold
  • text - required string - text to display with the bullet line
HTML Example
Do: example bullet text
Dont: example bullet text
Decap Usage

Catalog Image Widget

The Catalog Image widget has 9 properties, these are:

  • src: string required - path to the image you want to display, can be local file path or CDN based url
  • overlay: string optional - path to the image you want to display on hover, can be local file path or CDN based url
  • title: string optional - the title
  • description: string optional - markdown-formatted text description
  • light: boolean optional - a light checkered background
  • dark: boolean optional - a dark checkered background
  • scale: boolean optional - scale the image down if it’s wider than the container
  • span: number required - [1–6] width of the shortcode
  • text_position: string optional - can either be top to place the title and description above it or bottom to place it below it
HTML Example

Text Position Top

places the images title and description above it.

Text Position Bottom

places the images title and description below it.

Image with overlay

Displays alternate image on hover

Decap Usage

Code Block Widget

The Code Block widget allows you to insert code blocks into your markdown document, you can select the language for your code snippet by clicking the settings icon and selecting the appropriate mode for your code.

HTML Example
{
    "name":"John",
    "age":30,
    "car":null,
}
Decap Usage

Color Widget

The Color widget has 7 properties, these are:

  • name: optional string - defines the color name
  • span: required number - [1–6] width of the shortcode
  • hex: required string - defines the hex color value and sets the color of the example
  • RGB optional string - defines the RGB color value
  • Pantone optional string - defines the pantone color value
  • CMYK optional string - defines the CMYK color value
  • MUI optional string - defines MUI color value
HTML Example

Theme Primary Color

HEX: #003b5c

RGB: 0, 59, 92

PANTONE: 302 C

CMYK: 100%, 36%, 0%, 64%

Theme Secondary Color

HEX: #C6007E

RGB: 198, 0, 126

PANTONE: 233 C

CMYK: 0%, 100%, 36%, 22%

Decap Usage

Column Widget

The Column widget has 3 properties, these are:

  • span: required number - [1–6] width of the shortcode
  • color: optional rgba, rgb or hex color value - used to set the background color of the shortcode
  • alignment: optional string - can be either left, center or right to align the content of the shortcode. Defaults to left.
HTML Example
Span 1
Span 1
Span 1
Span 1
Span 1
Span 1
Span 2
Span 2
Span 2
Span 3
Span 3
Span 4
Span 2
Span 5
Span 1
Span 6
Decap Usage

Divider Title Widget

The Column widget has 2 properties, these are:

  • title: required string - the text to display above the divider
  • align: optional string - controls the text alignment, defaults to left
HTML Example
Left aligned title
Center aligned title
Right aligned title
Decap Usage

Download Widget

The Download widget has 5 properties, these are:

  • title: required string - The title for the button
  • span: required number - [1–6] width of the shortcode
  • url required string - The URL pointing to the file
  • filename: required string - Changes the file name under which it will be saved
  • subtitle: optional string - Other text you may want to display if no value is provided it will display the file size.
HTML Example
Decap Usage

Hint Widget

The Hint widget has 3 properties, these are:

  • span: required number -[1–6] width of the shortcode
  • type: required string - can be one of 4 types: Info, Danger, Warning and Success
  • content required markdown - you can write markdown between the opening and closing hint brackets
HTML Example
This is an info hint
This is an danger hint
This is an warning hint
This is an success hint
Decap Usage

Image Widget

In some cases you just need to insert an image without any of the advanced features provided by the Catalog Image Widget it is recommended you use the Image shortcode.

The Image widget has 3 properties, these are:

  • src: required string - The URL pointing to the image file
  • title optional string - used to display a title text for the image
  • Alt Text optional string - used to display a alternative text when the image cannot be loaded
HTML Example

Hugo Catalog Logo

Decap Usage

Video Widget

The Video widget has 6 properties, these are:

  • span: required number - [1–6] width of the shortcode
  • src: required string - the url path of your video
  • muted: optional boolean - if this value is set to true the video will be muted
  • loop: optional boolean - if this value is set to true the video will loop
  • autoplay: optional boolean - if this value is set to true the player will begin playing automatically
  • poster: optional string - the url path of the image path to use as the cover image
HTML Example & Decap Usage