Skip to content

SublimeText/Liquid

 
 

Repository files navigation

Liquid/Jekyll syntax for Sublime Text

Provides syntax highlighting for HTML and Markdown files with Shopify Liquid and Jekyll template tags.

For working with Jekyll, this package also provides proper syntax highlighting for yaml front matter.

Installation

Package Control

The easiest way to install is using Package Control. It's listed as Liquid.

  1. Open Command Palette using ctrl+shift+P or menu item Tools → Command Palette...
  2. Choose Package Control: Install Package
  3. Find Liquid and hit Enter

Manual Install

  1. Download appropriate Liquid-2.0.0-st4xxx.sublime-package for your Sublime Text build.
    The st4xxx suffix denotes the least required ST build for the sublime-package to work.
  2. Rename it to Liquid.sublime-package
  3. Copy it into Installed Packages directory

To find Installed Packages...

  1. call Menu > Preferences > Browse Packages..
  2. Navigate to parent folder

Usage

To enable the syntax, select Liquid > HTML (Liquid) or Liquid > Markdown (Liquid) from syntax selection menu or via Command Palette.

To always open your templates with this syntax, use the Open all with current extension as ... option, and select the proper Liquid syntax.

Troubleshooting

Liquid extends Sublime Text's HTML, Markdown, CSS and JavaScript, syntax definitions.

If Liquid syntax highlighting doesn't work and console displays syntax errors,

  1. check if required bundled packages are enabled.
  2. remove any out-dated syntax override.

Enable bundled packages

  1. Open Command Palette using ctrl+shift+P or menu item Tools → Command Palette...
  2. Choose Package Control: Enable Packages
  3. Find CSS and hit Enter
  4. Repeat the steps for JavaScript, HTML and Markdown

Remove overrides

  1. call Menu > Preferences > Browse Packages..
  2. Look for CSS, HTML, JavaScript, Markdown folder
  3. Remove them or at least delete any syntax definition in them