ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Color Scheme - Gray Matter

by philipbelesky ST2/ST3

A colour scheme for Sublime Text that takes design cues from popular minimalist Markdown text editors.

Details

Installs

  • Total 6K
  • Win 3K
  • OS X 2K
  • Linux 1K
Oct 22 Oct 21 Oct 20 Oct 19 Oct 18 Oct 17 Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9 Oct 8 Oct 7 Oct 6 Oct 5 Oct 4 Oct 3 Oct 2 Oct 1 Sep 30 Sep 29 Sep 28 Sep 27 Sep 26 Sep 25 Sep 24 Sep 23 Sep 22 Sep 21 Sep 20 Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8 Sep 7
Windows 3 3 1 4 3 4 3 2 4 10 6 1 5 3 0 3 0 3 7 2 6 1 4 0 5 6 7 5 3 2 4 3 3 9 6 2 5 11 13 5 3 1 4 1 2 2
OS X 0 1 0 2 1 2 1 1 1 2 0 0 1 1 1 1 1 0 0 3 0 0 2 0 2 4 1 2 0 2 2 2 1 3 5 2 4 2 2 4 1 1 0 0 0 1
Linux 0 2 1 4 1 1 0 1 1 0 4 2 0 2 0 0 2 2 2 1 1 1 1 1 4 2 3 3 1 0 0 1 0 2 1 1 0 1 6 2 0 0 0 1 0 0

Readme

Source
raw.​githubusercontent.​com

Gray Matter

A pair of colour schemes for writing Markdown in Sublime Text, Visual Studio Code, and other .tmTheme editors. It takes aesthetic cues from popular minimalist writing apps and aims to lessen the visual impact of markdown punctuation. It also attempts to support the full range of Markdown syntax ranging from Markdown, MultiMarkdown, Github Flavoured Markdown, and Pandoc Markdown.

Light Theme

Light Theme

Dark Theme

Dark Theme

Sublime Text Installation & Configuration

With Package Control

  1. Make sure that Package Control is already installed
  2. Choose Install Package from the Command Palette — Ctrl+Shift+P on Windows/Linux and ⇧⌘P on OS X
  3. Search for Gray Matter Color Schemes and hit Enter

Manual Install

  1. Clone or download the repo
  2. Choose Browse Packages from the Command Palette — Ctrl+Shift+P on Windows/Linux and ⇧⌘P on OS X
  3. Copy the repo folder into this directory

Setup

Note that this theme is specifically designed for Markdown. To configure Sublime Text such that this theme is always used for just Markdown files, first open up a Markdown file, and then in the menu bar open up the syntax-specific settings via Preferences > Settings - More > Syntax Specific - User.

Add in either:

"color_scheme": "Packages/Color Scheme - Gray Matter/Gray Matter Light.tmTheme",

Or:

"color_scheme": "Packages/Color Scheme - Gray Matter/Gray Matter Dark.tmTheme",

While in this file here are another few options you may want to consider in order to better match a more traditional Markdown text editor:

"draw_centered": true,
"font_size": 18,
"gutter": false,
"highlight_line": false,
"line_numbers": true,
"line_padding_bottom": 4,
"line_padding_top": 4,
"rulers": [],
"tab_size": 4,
"word_wrap": true,
"wrap_width": 90

Wider Syntax Support

Visual Studio Installation & Configuration

Currently the theme is available through the Visual Studio Marketplace. You can then activate it in the Preferences > Color Theme section of the menu.

Development

Tests

Tests use sublime_color_scheme_unit to test for regressions. Once installed (via Package Control) the :TestSuite command in the Command Palette will run the test set.

References/Aids

Building

A script builds the Dark version of the theme.

$ bash build.sh

Publishing

Sublime Text works with the .thTheme files in the root directory. To publish to Package Control just tag the version and push from master.

Visual Studio code uses the *-color-theme.json files in the root directory which contain a number of VSC-specific settings for the editor chrome and import the .tmTheme for basic syntax highlighting. To publish to the Visual Studio Marketplace (requires the vsce package from npm install):

$ vsce publish 1.2.0

Atom uses the .less files in gray-matter-X-syntax folders

Roadmap

  • Sublime Text Multimarkdown Grammars don't appear to exist for most footnote formats in-text such as [^ref] / [@Kullmann:2014bd 26] or for recognising the bottom reference to a footnote such as [^ref]: / [#Doe:2011]:.
  • Sublime Text Multimarkdown Grammars don't appear to exist for recognising the actual text part of an ATX style header
  • Sublime Text Multimarkdown Grammars don't appear to exist for getting the syntax elements (ie the 1. or -) for lists beyond the first item.

License

The MIT license.

Acknowledgements

This colour scheme is heavily drawn from the visual style of Byword, iA Writer, and Ulysses. I love both applications, but also like to make using of Sublime's more advanced features while writing.

See DEVELOPMENT.md for information on Pull Requests, the Roadmap, etc.