Want to take your software engineering career to the next level? Join the mailing list for career tips & advice Click here


:memo: Streamline your writing in Jekyll with these commands.

Subscribe to updates I use jekyll-compose

Statistics on jekyll-compose

Number of watchers on Github 308
Number of open issues 6
Average time to close an issue about 2 months
Main language Ruby
Average time to merge a PR 15 days
Open pull requests 6+
Closed pull requests 5+
Last commit over 2 years ago
Repo Created about 6 years ago
Repo Last Updated over 2 years ago
Size 105 KB
Homepage http://rubygems.o...
Organization / Authorjekyll
Latest Releasev0.7.0
Page Updated
Do you use jekyll-compose? Leave a review!
View open issues (6)
View jekyll-compose activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Software engineers: It's time to get promoted. Starting NOW! Subscribe to my mailing list and I will equip you with tools, tips and actionable advice to grow in your career.
Evaluating jekyll-compose for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)


Streamline your writing in Jekyll with some commands.

Build Status


Add this line to your application's Gemfile:

gem 'jekyll-compose', group: [:jekyll_plugins]

And then execute:

$ bundle


After you have installed (see above), run bundle exec jekyll help and you should see:

Listed in help you will see new commands available to you:

  draft      # Creates a new draft post with the given NAME
  post       # Creates a new post with the given NAME
  publish    # Moves a draft into the _posts directory and sets the date
  unpublish  # Moves a post back into the _drafts directory
  page       # Creates a new page with the given NAME

Create your new page using:

$ bundle exec jekyll page "My New Page"

Create your new post using:

$ bundle exec jekyll post "My New Post"

Create your new draft using:

$ bundle exec jekyll draft "My new draft"

Publish your draft using:

$ bundle exec jekyll publish _drafts/my-new-draft.md
# or specify a specific date on which to publish it
$ bundle exec jekyll publish _drafts/my-new-draft.md --date 2014-01-24

Unpublish your post using:

$ bundle exec jekyll unpublish _posts/2014-01-24-my-new-draft.md


  1. Fork it ( http://github.com/jekyll/jekyll-compose/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Run the specs (script/cibuild)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create new Pull Request
jekyll-compose open issues Ask a question     (View All Issues)
  • over 3 years Generated filename should not have accents
  • over 3 years Titles should be quoted/escaped
  • over 3 years Publishing a draft with a date in the front-matter should use that date instead
  • almost 4 years Support the source configuration setting
  • almost 4 years Tests fail intermittently
jekyll-compose open pull requests (View All Pulls)
  • Allow additional front matter for Post
  • Add date to front matter in new posts
  • Execute FileInfo tests in source_dir, Fix tests
  • WIP add date to post when publishing
  • Formatting of dates and times in a DRY manner
  • Auto open newly generated files in selected editor
jekyll-compose list of languages used
jekyll-compose latest release notes
v0.7.0 v0.7.0

Development Fixes

  • Add Rubocop autorrect offenses (#57)
  • Test against Ruby 2.5 (#56)

Minor Enhancements

  • Check if a file should be overwritten when publishing or unpublishing a post (#59)
v0.6.0 v0.6.0

Development Fixes

  • Modernize Travis config (#53)
  • Define path with dir (#51)
  • Inherit Jekyll's rubocop config for consistency (#52)
  • Execute FileInfo tests in source_dir, Fix tests (#46)

Minor Enhancements

  • Add date to front matter when publish (#54)
v0.5.0 v0.5.0
  • Allow Jekyll Source Directory (#42)
  • Ensure colons do not break titles (#39)
  • Require Jekyll 3 or higher (#40)
Other projects in Ruby