VS Code Org Mode

⚠️ The publisher name was changed, tootone/org-mode has become vscode-org-mode/org-mode ⚠️

VS Code Org Mode is an extension for Visual Studio Code inspired by the venerable Org mode for Emacs. Org lets you keep notes, maintain TODO lists, and author documents, all in plain text.

We welcome issues, feature requests, and contributions to the repo.

Features

Keep Notes

Create outlines:

Promote and demote items:

Maintain TODO Lists

Create TODOs:

Change TODO status:

Customize your TODO Keywords:

Insert timestamps:

Modify dates:

Author Documents

Style your text:

Add metadata with a snippet:

Add links with a snippet:

Add comments:

Settings

Keybindings

All actions in VS Code Org mode come packaged with default keybindings. These can be modified in your keybindings.json file.

Custom TODO Keywords

TODO keywords can be customized in settings.json. For example:

"org.todoKeywords": [
    "TODO",
    "DONE",
    "WAIT",
    "SCHD"
]

Installation

Org Mode can be installed in a number of ways:

• Launch VS Code Quick Open (Linux / Windows: ctrl+P; Mac: cmd+P) and type ext install org-mode.
• Search for org mode in the Extensions view in VS Code.

Activation

The extension can be activated in two ways:

1. Save a file with the extension .org.
2. Change the language mode to Org by either
   • Clicking in the lower right corner to the left of the smiley face
   • Typing change language mode into the command palette
   • Using the default shortcut
     • Linux / Windows: ctrl+k m
     • Mac: cmd+k m

Docs

Detailed documentation is kept in the GitHub Wiki.

Contributing

We welcome pull requests.

Please read CONTRIBUTING.md before submitting a pull request. It explains our PR guidelines, review process, and required templates. Details are centralized in CONTRIBUTING.md.

Gratitude

The original Org mode was written for Emacs by Carsten Dominik, with the help and support of an impressive list of geniuses. Our work is inspired by though not associated with their original masterpiece. In addition, many aspects of the extension were inspired by the Spacemacs Org layer.

Our unicorn icon is based on an image by M. Turan Ercan for the Noun Project. We're grateful to them for making the image available under the Creative Commons license.

License

This work is available under the GNU General Public License v3.

Requirements

Install the extension. The rest will be taken care of.

Known Issues

Colorization

Colorization, bolding, italicization, and other modes of highlighting are handled differently by different themes. We have prioritized supporting the default VS Code themes (Dark+ and Light+). This prioritization means that some colors may not appear as expected in other themes, or that opportunities for more variance have been missed.

Others

See GitHub Issues.

Release Notes

See CHANGELOG.md.