runtime/help/help.md

   1 # Micro help text
   2
   3 Micro is a terminal-based text editor that aims to be easy to use and intuitive,
   4 while also taking advantage of the full capabilities of modern terminals.
   5
   6 ### Accessing more help
   7
   8 Micro has a built-in help system much like Vim's (although less extensive).
   9
  10 To use it, press CtrlE to access command mode and type in help followed by a topic.
  11 Typing help followed by nothing will open this page.
  12
  13 Here are the possible help topics that you can read:
  14
  15 * keybindings: Gives a full list of the default keybindings as well as how to rebind them
  16 * commands: Gives a list of all the commands and what they do
  17 * options: Gives a list of all the options you can customize
  18 * plugins: Explains how micro's plugin system works and how to create your own plugins
  19 * colors: Explains micro's colorscheme and syntax highlighting engine and how to create your
  20   own colorschemes or add new languages to the engine
  21
  22 For example to open the help page on plugins you would press CtrlE and type `help plugins`.
  23
  24 ### Usage
  25
  26 Once you have built the editor, simply start it by running
  27 `micro path/to/file.txt` or simply `micro` to open an empty buffer.
  28
  29 Micro also supports creating buffers from stdin:
  30
  31 ```
  32 $ ifconfig | micro
  33 ```
  34
  35 You can move the cursor around with the arrow keys and mouse.