Vim Fundamentals: Edit, Save, and Search

The Core Idea: Modal Editing

Before you type a single command, you must understand the one thing that makes Vim different from most editors you've used: Vim is a modal editor. This means the same keys on your keyboard do different things depending on which mode you are in.

For today, we only need to focus on two primary modes:

1. Normal Mode (also called Command Mode): This is the default mode you're in when you first open Vim. In this mode, keystrokes are interpreted as commands (e.g., to move the cursor, delete text, or search). You cannot type text directly in this mode.
2. Insert Mode: This is the mode where Vim behaves like a regular text editor. Once you're in Insert Mode, whatever you type appears in the file.

To switch between these modes:

• From Normal Mode, press i to enter Insert Mode.
• From Insert Mode, press the Esc key to return to Normal Mode.

This concept is so fundamental that it's worth seeing visually.

To get a solid grasp of this concept, a short read from an excellent guide by freeCodeCamp will be very helpful.

Learning by Doing: Your First vimtutor Session

The single best way to learn Vim is by using vimtutor, an interactive tutorial that comes pre-installed with Vim. It's designed to be completed inside Vim itself, forcing you to use the commands as you learn them. This aligns perfectly with your preference for hands-on practice.

Do It Yourself: Start the Tutor

1. Open your terminal.
2. Type the following command and press Enter:

   vimtutor
   

   This will open a special text file with instructions. The tutorial is self-contained and will guide you through the lessons.
3. For today's lesson, focus on completing Lesson 1.1 through Lesson 2.2. This will take about 20-25 minutes and will cover:
   • Moving the cursor
   • Exiting Vim (:q!)
   • Text editing (deleting, inserting)
   • Saving your work (:wq)

Don't worry about memorizing everything perfectly. The goal is to build initial muscle memory. When you've completed up to Lesson 2.2, you can quit the tutor by pressing Esc to ensure you are in Normal Mode, then typing :q! and pressing Enter.

Reinforcing the Basics: Open, Insert, Save, Quit, Search

You've now had a hands-on introduction with vimtutor. Let's consolidate those core commands with a clear summary and video examples.

A fantastic, beginner-friendly video from SavvyNik walks through these exact steps. We'll watch it in segments to focus on each operation.

1. Opening and Creating Files

You can open an existing file or create a new one by simply typing vim followed by the filename.

# To open an existing file named 'config.txt'
vim config.txt




# To create a new file named 'new_notes.md'
vim new_notes.md

Watch this short clip to see it in action.

Note: The video uses apt for installation on a Debian-based system. On your Fedora system, Vim is likely already installed. If not, the command would be sudo dnf install vim.

2. Inserting Text

Once a file is open, you're in Normal Mode. To start typing, you must enter Insert Mode.

• i: Enters Insert Mode and starts typing before the cursor.
• a: Enters Insert Mode and starts typing after the cursor (append).
• o: Creates a new line below the current line and enters Insert Mode.
• O: Creates a new line above the current line and enters Insert Mode.

Remember to press Esc to return to Normal Mode when you're done typing.

3. Saving and Quitting

All save and quit commands are typed in Normal Mode and start with a colon (:), which opens the Command-Line Mode at the bottom of the screen.

• :w - Write the changes to the file (saves it), but stays in Vim.
• :q - Quit Vim. This only works if you haven't made any unsaved changes.
• :wq or :x - Write and Quit. This is the most common way to save your work and exit.
• :q! - Quit and discard any changes you've made. The ! forces the action.

4. Searching for Text

To find a piece of text within a file, you don't need to read every line.

1. In Normal Mode, press the / key.
2. Type the word or pattern you're looking for and press Enter.
3. Vim will jump to the first match.
4. Press n to jump to the next match.
5. Press N (Shift + n) to jump to the previous match.

For quick reference, here is a handy cheat sheet. It contains many advanced commands, but you can focus on the basic sections we've discussed today.

Your Turn: Putting It All Together

Let's apply what you've just reviewed with a practical task related to your goals.

1. Open your terminal.
2. Create a new file called django_project_ideas.txt using Vim.

   vim django_project_ideas.txt
   

3. Press i to enter Insert Mode.
4. Type a few lines about potential Django projects. For example:

   My Django Project Ideas
   - A personal portfolio website to showcase my graphics design and programming skills.
   - A web-based inventory tracker.
   - An automation script dashboard.
   

5. Press Esc to go back to Normal Mode.
6. Save and quit the file by typing :wq and pressing Enter.
7. Now, re-open the file: vim django_project_ideas.txt.
8. In Normal Mode, search for the word "website". Type /website and press Enter.
9. Press a to append text after the cursor. Add "(using Django and PostgreSQL)".
10. Press Esc to return to Normal Mode.
11. This time, quit without saving your last change. Type :q! and press Enter.
12. Verify your last change was discarded by viewing the file's content with cat django_project_ideas.txt. The text you added in step 9 should be gone.

Conclusion

Excellent work! You've successfully navigated the initial—and most challenging—part of learning Vim. It feels strange at first, but with practice, the modal editing model becomes second nature and a powerful tool in your developer arsenal.

Key Takeaways:

• Vim is Modal: You switch between Normal Mode (for commands) and Insert Mode (for typing). The Esc key is your reliable way to return to Normal Mode.
• Open: vim filename
• Insert: i to start typing, Esc to stop.
• Save/Quit: Commands start with : in Normal Mode. :wq saves and quits, while :q! quits and discards changes.
• Search: Use / to find text, and n/N to navigate matches.
• Practice is Everything: Continue using vimtutor and try to use Vim for simple text editing tasks to build your muscle memory.

In our next lesson, we will look at other ways to interact with text files from the command line. You'll learn how to view file contents quickly without opening an editor, using commands like cat, less, head, and tail. This will complement your new editing skills perfectly.