micro(1)

πŸ“¦
version 2.0.15 Β· 2 versions
, in alpine 3.24, arch rolling, nixpkgs unstable, ubuntu resolute, ubuntu stonking

✨ micro(1) ✨ β€” the manual page bestie, but make it iconic

okay so like, this is the manual page for micro, and we're in the General Commands Manual section, section 1, commands, you know the vibe πŸ’…


🌸 NAME 🌸

micro β€” a modern and intuitive terminal-based text editor. she's cute, she's fast, she's literally right there in your terminal πŸ¦‹


πŸŽ€ SYNOPSIS πŸŽ€

micro [OPTION]... [FILE]... [+LINE[:COL]] [+/REGEX]
micro [OPTION]... [FILE[:LINE[:COL]]]...  (only if the `parsecursor`
option is enabled)

so yeah, second form? only works if you've got the parsecursor option turned on. iykyk ✨


πŸ’– DESCRIPTION πŸ’–

Micro is a terminal-based text editor that's all about being easy to use and intuitive, while ALSO flexing the full capabilities of modern terminals. she ships as one single, batteries-included, static binary with no dependencies. no cap. one binary. that's it. πŸ‘‘

as the name suggests (and bestie, the name is doing a LOT), micro is kinda aiming to be a successor to the nano editor β€” easy to install, easy to use in a pinch when you're in a hurry. BUT micro also wants to be enjoyable to use full time, whether you're living in the terminal because you prefer it (like the author, same honestly), or because you need to (over ssh, we've all been there 😭).

Use Ctrl-q to quit, Ctrl-s to save, and Ctrl-g to open the in-editor help menu. that's it. those three. memorize them. they will save your life. 🫢


✨ OPTIONS ✨

  • -clean β€” clean the configuration directory and dip. exit. done. 🧹
  • -config-dir dir β€” specify a custom location for the configuration directory, if you're feeling fancy about where your config lives πŸ’…

🌈 line/column starting positions 🌈

  • FILE:LINE[:COL] β€” only if the parsecursor option is enabled. specify a line and column to start the cursor at when opening a buffer 🎯
  • FILE +LINE[:COL] β€” same idea, specify a line and column to start the cursor at when opening a buffer
  • +/REGEX β€” specify a regex to search for when opening a buffer πŸ”

πŸ¦‹ other flags πŸ¦‹

  • -options β€” show all options help and exit πŸ“‹
  • -debug β€” enable debug mode (which enables logging to ./log.txt) πŸ›
  • -profile β€” enable CPU profiling (writes profile info to ./micro.prof so it can be analyzed later with "go tool pprof micro.prof") πŸ”₯
  • -version β€” show the version number and information and exit ⭐

🧚 plugin management 🧚

micro's plugins can be managed at the command line with the following commands:

  • -plugin install [PLUGIN]... β€” install plugin(s) πŸ’–
  • -plugin remove [PLUGIN]... β€” remove plugin(s) πŸ™ˆ
  • -plugin update [PLUGIN]... β€” update plugin(s) β€” and if no argument is given, it updates all plugins πŸ‘‘
  • -plugin search [PLUGIN]... β€” search for a plugin πŸ”
  • -plugin list β€” list installed plugins πŸ“
  • -plugin available β€” list available plugins 🌟

πŸ’œ setting options from the command line πŸ’œ

micro's options can ALSO be set via command line arguments for quick adjustments. but for real configuration, bestie, please use the settings.json file (see 'help options').

  • -<option> value β€” set option to value for this session. for example: micro -syntax off file.c

use micro -options to see the full list of configuration options ✨


🌸 CONFIGURATION 🌸

micro uses $MICRO_CONFIG_HOME as the configuration directory. if that environment variable is not set, it uses $XDG_CONFIG_HOME/micro instead. and if THAT environment variable isn't set either, it uses ~/.config/micro as the configuration directory.

so basically a little chain of fallbacks, she's flexible like that 🫢

in the documentation, we use ~/.config/micro to refer to the configuration directory β€” even if it's actually somewhere else because you set one of those environment variables up top. just so we're all on the same page πŸ’…


πŸ’€ NOTICE πŸ’€

this manpage is intended only to serve as a quick guide to the invocation of micro. it is not intended to replace the full documentation included with micro, which can be accessed from within micro itself. micro literally tells you what key combination to press to get help β€” look in the lower right. πŸ‘€


πŸ› BUGS πŸ›

a comprehensive list of bugs will not be listed in this manpage, bestie. see the Github page at https://github.com/zyedidia/micro/issues for a list of known bugs, and to report any newly encountered bugs you may find. we strive to correct bugs as swiftly as possible 🫑


Copyright Β© 2020 Zachary Yedidia, et al. MIT license. see https://github.com/zyedidia/micro for details.


and that's the whole page, bestie!! this one's dated 2025-09-03 and it's page micro(1) β€” so like, when you go looking for her again in the manual, that's the tag, that's the footer, that's the vibe πŸ’– stay slaying in your terminal, ily πŸ¦‹βœ¨

πŸ“¦ where this page comes from