sublime-jekyll

Maintenance mode: This package is no longer in active development. Version 4.0.0 restores compatibility with current Sublime Text 4 and fixes outstanding bugs. No new features are planned. Bug-fix PRs may be reviewed as time allows.

Version 4.0.0 was prepared with help from AI coding tools (Claude Code and Codex). The maintainer reviewed the changes; testing combined automated checks, agent-run checks in Sublime Text, and the maintainer's own testing.

sublime-jekyll is a Sublime Text package for Jekyll static sites.

This package is aimed at streamlining the process of managing and creating new Jekyll posts. It does this by providing quick and easy access to new post and draft commands, snippets and completions for Liquid template tags and filters, as well as some handy commands for adding dates and upload links to your posts.

If you use Jekyll as your static site generator, and Sublime Text as your text editor, you should absolutely install and use this package!

Installation

Version 4.0.0 requires Sublime Text 4, build 4083 or later, and uses the modern Python plugin host. Sublime Text 3 users should stay on 3.1.7.

The recommended way to install and update this package is using Package Control. Search for Jekyll and install the latest version. If you prefer to install this package manually, you can git clone this repo or extract the ZIP archive into your Sublime Text Packages folder.

Settings and paths

Paths can be absolute, use Sublime variables such as ${project_path} (the saved project directory) and ${folder} (the first open folder), or start with ~ for your home directory. Relative paths use the first open folder, or the saved project directory if no folders are open.

Explicit paths take priority. Otherwise, the package checks open folders and their immediate children for _config.yml or _config.yaml, then uses existing _posts, _drafts, or uploads folders in those sites. Optional jekyll_auto_find_paths searches to depth four if no site match is found. Templates use jekyll_templates_path or Packages/User/Jekyll Templates.

The old settings migration and backup browsing commands, and jekyll_utility_disable, have been removed. Update old settings by hand using the settings guide, which also covers lookup order and project overrides.

Documentation

Installation instructions, available commands and features, detailed documentation, and FAQs can be found at Read the Docs.

License

sublime-jekyll is licensed under the MIT license. LICENSE

This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to github@rymo.io.