Something went wrong. Try again.
Fork of micro-editor/micro
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147.TH micro 1 "2025-09-03".SH NAMEmicro \- A modern and intuitive terminal-based text editor.SH SYNOPSIS.B micro.RI [ OPTION ]...\&.RI [ FILE ]...\&.RI [+ LINE [: COL ]]\&.RI [+/ REGEX ].br.B micro.RI [ OPTION ]...\&.RI [ FILE [: LINE [: COL ]]]...\&\& (only if the `parsecursor` option is enabled).SH DESCRIPTIONMicro is a terminal-based text editor that aims to be easy to use and intuitive, while also taking advantage of the full capabilitiesof modern terminals. It comes as one single, batteries-included, static binary with no dependencies.
As the name indicates, micro aims to be somewhat of a successor to the nano editor by being easy to install and use in a pinch, but micro also aims to beenjoyable to use full time, whether you work in the terminal because you prefer it (like me), or because you need to (over ssh).
Use Ctrl-q to quit, Ctrl-s to save, and Ctrl-g to open the in-editor help menu..SH OPTIONS.PP.B \-clean.RS 4Clean the configuration directory and exit.RE.PP.B \-config-dir.I dir.RS 4Specify a custom location for the configuration directory.RE.PP.IR FILE : LINE [: COL ](only if the `parsecursor` option is enabled).br.IR FILE \ + LINE [: COL ].RS 4Specify a line and column to start the cursor at when opening a buffer.RE.PP.RI +/ REGEX.RS 4Specify a regex to search for when opening a buffer.RE.PP.B \-options.RS 4Show all options help and exit.RE.PP.B \-debug.RS 4Enable debug mode (enables logging to ./log.txt).RE.PP.B \-profile.RS 4Enable CPU profiling (writes profile info to ./micro.prof so it can be analyzed later with "go tool pprof micro.prof").RE.PP.B \-version.RS 4Show the version number and information and exit.RE.PP.B \-exec.I command.RS 4Run a command after the editor initializes (may be repeated).RE
Micro's plugins can be managed at the command line with the following commands..RS 4.PP.B \-plugin install.RI [ PLUGIN ]....RS 4Install plugin(s).RE.PP.B \-plugin remove.RI [ PLUGIN ]....RS 4Remove plugin(s).RE.PP.B \-plugin update.RI [ PLUGIN ]....RS 4Update plugin(s) (if no argument is given, updates all plugins).RE.PP.B \-plugin search.RI [ PLUGIN ]....RS 4Search for a plugin.RE.PP.B \-plugin list.RS 4List installed plugins.RE.PP.B \-plugin available.RS 4List available plugins.RE.RE
Micro's options can also be set via command line arguments for quickadjustments. For real configuration, please use the settings.jsonfile (see 'help options')..RS 4.PP.BI \-< option >.I value.RS 4Set `option` to `value` for this session..brFor example: `micro -syntax off file.c`.RE.RE.PPUse `micro -options` to see the full list of configuration options..SH CONFIGURATIONMicro uses $MICRO_CONFIG_HOME as the configuration directory.If this environment variable is not set, it uses $XDG_CONFIG_HOME/micro instead.If that environment variable is not set, it uses ~/.config/micro as the configuration directory.In the documentation, we use ~/.config/micro to refer to the configuration directory(even if it may in fact be somewhere else if you have set either of the above environment variables)..SH NOTICEThis manpage is intended only to serve as a quick guide to the invocation of micro and is not intended to replace the full documentation included with microwhich can be accessed from within micro. Micro tells you what key combination topress to get help in the lower right..SH BUGSA comprehensive list of bugs will not be listed in this manpage. See the Githubpage at \fBhttps://github.com/micro-editor/micro/issues\fP for a list of known bugsand to report any newly encountered bugs you may find. We strive to correctbugs as swiftly as possible..SH COPYRIGHTCopyright \(co 2020 Zachary Yedidia, et al. MIT license.See \fBhttps://github.com/micro-editor/micro\fP for details.