Fix markdownlint issues in all markdown files

Author: openhands-agent

.github/ISSUE_TEMPLATE/bug_report.md

@@ -57,4 +57,4 @@ For faster debugging, try to reproduce the issue using our minimal configuration
    ```bash
    nvim --clean -u minimal-init.lua
    ```
-4. Try to reproduce the issue with this minimal setup
+4. Try to reproduce the issue with this minimal setup

.github/ISSUE_TEMPLATE/feature_request.md

@@ -25,4 +25,4 @@ Describe how this feature would be used and who would benefit from it.
 
 ## Additional Context
 
-Add any other context, screenshots, or examples about the feature request here.
+Add any other context, screenshots, or examples about the feature request here.

.github/PULL_REQUEST_TEMPLATE.md

@@ -34,4 +34,4 @@ Add screenshots to help explain your changes if they include visual elements.
 
 ## Additional Notes
 
-Add any other context about the PR here.
+Add any other context about the PR here.

CHANGELOG.md

@@ -8,30 +8,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 ### Added
+
 - New `split_ratio` config option to replace `height_ratio` for better handling of both horizontal and vertical splits
 
 ### Fixed
+
 - Fixed vertical split behavior when the window position is set to a vertical split command
 
 ## [0.4.2] - 2025-03-03
 
 ### Changed
+
 - Moved documentation validation to a dedicated workflow for better standardization
 
 ### Fixed
+
 - Fixed test runner not properly exiting after tests
 - Improved which-key handling in test environment
 - Fixed window focus issues in terminal split
 
 ## [0.4.1] - 2025-03-03
 
 ### Changed
+
 - Improved GitHub workflows with consolidated documentation checks
 - Enhanced release workflow with more reliable changelog generation
 - Updated dependency handling in CI workflows
 - Refined workflow trigger conditions for better performance
 
 ### Fixed
+
 - Fixed deprecated changelog generator in release workflow
 - Fixed documentation validation in CI pipeline
 - Resolved Markdown linting and validation issues
@@ -40,6 +46,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.4.0] - 2025-03-02
 
 ### Added
+
 - GitHub Discussions integration
 - Release automation workflow
 - Acknowledgements section in README
@@ -50,11 +57,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Keymap tests for custom key mappings
 
 ### Changed
+
 - Improved README organization and structure
 - Standardized GitHub workflow naming conventions
 - Enhanced test infrastructure with accurate test counting
 
 ### Fixed
+
 - Renamed test initialization file for consistency (minimal_init.lua → minimal-init.lua)
 - Test script execution in pre-commit hooks
 - References to test initialization files in documentation

CLAUDE.md

@@ -1,16 +1,19 @@
 # Project: Claude Code Plugin
 
 ## Overview
+
 Claude Code Plugin provides seamless integration between the Claude Code AI assistant and Neovim. It enables direct communication with the Claude Code CLI from within the editor, context-aware interactions, and various utilities to enhance AI-assisted development within Neovim.
 
 ## Essential Commands
+
 - Run Tests: `env -C /home/gregg/Projects/neovim/plugins/claude-code lua tests/run_tests.lua`
 - Check Formatting: `env -C /home/gregg/Projects/neovim/plugins/claude-code stylua lua/ -c`
 - Format Code: `env -C /home/gregg/Projects/neovim/plugins/claude-code stylua lua/`
 - Run Linter: `env -C /home/gregg/Projects/neovim/plugins/claude-code luacheck lua/`
 - Build Documentation: `env -C /home/gregg/Projects/neovim/plugins/claude-code mkdocs build`
 
 ## Project Structure
+
 - `/lua/claude-code`: Main plugin code
 - `/lua/claude-code/cli`: Claude Code CLI integration
 - `/lua/claude-code/ui`: UI components for interactions
@@ -20,13 +23,15 @@ Claude Code Plugin provides seamless integration between the Claude Code AI assi
 - `/doc`: Vim help documentation
 
 ## Current Focus
+
 - Integrating nvim-toolkit for shared utilities
 - Adding hooks-util as git submodule for development workflow
 - Enhancing bidirectional communication with Claude Code CLI
 - Implementing better context synchronization
 - Adding buffer-specific context management
 
 ## Multi-Instance Support
+
 The plugin supports running multiple Claude Code instances, one per git repository root:
 
 - Each git repository maintains its own Claude instance
@@ -37,6 +42,7 @@ The plugin supports running multiple Claude Code instances, one per git reposito
 - Buffer names include the git root path for easy identification
 
 Example configuration to disable multi-instance mode:
+
 ```lua
 require('claude-code').setup({
   git = {
@@ -46,5 +52,6 @@ require('claude-code').setup({
 ```
 
 ## Documentation Links
+
 - Tasks: `/home/gregg/Projects/docs-projects/neovim-ecosystem-docs/tasks/claude-code-tasks.md`
-- Project Status: `/home/gregg/Projects/docs-projects/neovim-ecosystem-docs/project-status.md`
+- Project Status: `/home/gregg/Projects/docs-projects/neovim-ecosystem-docs/project-status.md`

CODE_OF_CONDUCT.md

@@ -35,4 +35,4 @@ Instances of unacceptable behavior may be reported by contacting the project tea
 
 ## Attribution
 
-This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.0, available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.0, available at [Contributor Covenant v2.0](https://www.contributor-covenant.org/version/2/0/code_of_conduct.html).

CONTRIBUTING.md

@@ -53,18 +53,20 @@ To set up a development environment:
 
 1. Read the [DEVELOPMENT.md](DEVELOPMENT.md) guide to ensure you have all necessary tools installed
 2. Clone your fork of the repository
-```bash
-git clone https://github.com/greggh/claude-code.nvim.git
-```
+
+   ```bash
+   git clone https://github.com/greggh/claude-code.nvim.git
+   ```
 
 3. Link the repository to your Neovim plugins directory or use your plugin manager's development mode
 
 4. Make sure you have the Claude Code CLI tool installed and properly configured
 
 5. Set up the Git hooks for automatic code formatting:
-```bash
-./scripts/setup-hooks.sh
-```
+
+   ```bash
+   ./scripts/setup-hooks.sh
+   ```
 
 This will set up pre-commit hooks to automatically format Lua code using StyLua before each commit.
 
@@ -90,6 +92,7 @@ The [DEVELOPMENT.md](DEVELOPMENT.md) file contains detailed information about:
 We use [StyLua](https://github.com/JohnnyMorganz/StyLua) to enforce consistent formatting of the codebase. The formatting is done automatically via pre-commit hooks if you've set them up using the script provided.
 
 Key style guidelines:
+
 - Configuration is in `stylua.toml` at the project root
 - Maximum line length is 120 characters
 - Use 2 spaces for indentation
@@ -144,4 +147,4 @@ By contributing to Claude-Code.nvim, you agree that your contributions will be l
 
 If you have any questions about contributing, please open an issue with your question.
 
-Thank you for contributing to Claude-Code.nvim!
+Thank you for contributing to Claude-Code.nvim!

DEVELOPMENT.md

@@ -134,11 +134,13 @@ luarocks install luacheck
 ### Setting Up the Environment
 
 1. Clone the repository:
+
    ```bash
    git clone https://github.com/greggh/claude-code.nvim.git
    ```
 
 2. Install Git hooks:
+
    ```bash
    cd claude-code.nvim
    ./scripts/setup-hooks.sh
@@ -154,11 +156,13 @@ luarocks install luacheck
 ### Pre-commit Hooks
 
 The pre-commit hook automatically runs:
+
 1. Code formatting with stylua
 2. Linting with luacheck
 3. Basic tests
 
 If you need to bypass these checks, use:
+
 ```bash
 git commit --no-verify
 ```
@@ -209,6 +213,7 @@ Understanding why we use each tool helps in appreciating their role in the devel
 ### Neovim
 
 Neovim is the primary development platform and runtime environment. We use version 0.10.0+ because it provides:
+
 - Better API support for plugin development
 - Improved performance for larger codebases
 - Enhanced LSP integration
@@ -217,6 +222,7 @@ Neovim is the primary development platform and runtime environment. We use versi
 ### StyLua
 
 StyLua is a Lua formatter specifically designed for Neovim configurations. It:
+
 - Ensures consistent code style across all contributors
 - Formats according to Lua best practices
 - Handles Neovim-specific formatting conventions
@@ -227,6 +233,7 @@ Our configuration uses 2-space indentation and 100-character line length limits.
 ### LuaCheck
 
 LuaCheck is a static analyzer that helps catch issues before they cause problems:
+
 - Identifies syntax errors and semantic issues
 - Flags unused variables and unused function parameters
 - Detects global variable access without declaration
@@ -238,6 +245,7 @@ We configure LuaCheck with `.luacheckrc` files that define project-specific glob
 ### Ripgrep & FD
 
 These tools improve development efficiency:
+
 - **Ripgrep**: Extremely fast code searching to find patterns and references
 - **FD**: Fast alternative to `find` for locating files in complex directory structures
 
@@ -250,7 +258,9 @@ These tools improve development efficiency:
 
 All our Neovim projects follow a similar structure:
 
+```plaintext
 ```
+
 .
 ├── .github/            # GitHub-specific files and workflows
 ├── .githooks/          # Git hooks for pre-commit validation
@@ -259,10 +269,16 @@ All our Neovim projects follow a similar structure:
 ├── test/               # Basic test modules
 ├── tests/              # Extended test suites
 ├── .luacheckrc         # LuaCheck configuration
+
+```plaintext
+```
+
 ├── .stylua.toml        # StyLua configuration
 ├── Makefile            # Common commands
 ├── CHANGELOG.md        # Project version history
 └── README.md           # Project overview
+
+```plaintext
 ```
 
 ## Troubleshooting
@@ -272,14 +288,15 @@ All our Neovim projects follow a similar structure:
 - **stylua not found**: Make sure it's installed and in your PATH
 - **luacheck errors**: Run `make lint` to see specific issues
 - **Test failures**: Use `make test-verbose` for detailed output
-- **Module not found errors**: Check that you're using the correct module name and path 
+- **Module not found errors**: Check that you're using the correct module name and path
 - **Plugin functionality not loading**: Verify your Neovim version is 0.10.0 or higher
 
 ### Getting Help
 
 If you encounter issues:
+
 1. Check the error messages carefully
 2. Verify all dependencies are correctly installed
 3. Check that your Neovim version is 0.10.0 or higher
 4. Review the project's issues on GitHub for similar problems
-5. Open a new issue with detailed reproduction steps if needed
+5. Open a new issue with detailed reproduction steps if needed

README.md

@@ -1,5 +1,3 @@
-<div align="center">
-
 # Claude Code Neovim Plugin
 
 [![GitHub License](https://img.shields.io/github/license/greggh/claude-code.nvim?style=flat-square)](https://github.com/greggh/claude-code.nvim/blob/main/LICENSE)
@@ -13,17 +11,15 @@
 
 *A seamless integration between [Claude Code](https://github.com/anthropics/claude-code) AI assistant and Neovim*
 
-[Features](#features) • 
-[Requirements](#requirements) • 
-[Installation](#installation) • 
-[Configuration](#configuration) • 
-[Usage](#usage) • 
-[Contributing](#contributing) • 
+[Features](#features) •
+[Requirements](#requirements) •
+[Installation](#installation) •
+[Configuration](#configuration) •
+[Usage](#usage) •
+[Contributing](#contributing) •
 [Discussions](https://github.com/greggh/claude-code.nvim/discussions)
 
-<img src="https://github.com/greggh/claude-code.nvim/blob/main/assets/claude-code.png?raw=true" alt="Claude Code in Neovim" width="800" />
-
-</div>
+![Claude Code in Neovim](https://github.com/greggh/claude-code.nvim/blob/main/assets/claude-code.png?raw=true)
 
 This plugin was built entirely with Claude Code in a Neovim terminal, and then inside itself using Claude Code for everything!
 
@@ -120,7 +116,7 @@ require("claude-code").setup({
     -- Conversation management
     continue = "--continue", -- Resume the most recent conversation
     resume = "--resume",     -- Display an interactive conversation picker
-    
+
     -- Output options
     verbose = "--verbose",   -- Enable verbose logging with full turn-by-turn output
   },
@@ -209,7 +205,7 @@ This plugin:
 4. Provides convenient keymaps and commands for toggling the terminal
 5. Automatically detects git repositories and sets working directory to the git root
 
-## Contributing 
+## Contributing
 
 Contributions are welcome! Please check out our [contribution guidelines](CONTRIBUTING.md) for details on how to get started.
 
@@ -264,6 +260,4 @@ make format
 
 ---
 
-<div align="center">
-  <p>Made with ❤️ by <a href="https://github.com/greggh">Gregg Housh</a></p>
-</div>
+Made with ❤️ by [Gregg Housh](https://github.com/greggh)

ROADMAP.md

@@ -65,4 +65,4 @@ If you have feature requests or would like to contribute to the roadmap, please:
 2. If not, open a new issue with the "enhancement" label
 3. Explain how your idea would improve the Claude Code plugin experience
 
-We welcome community contributions to help achieve these goals! See [CONTRIBUTING.md](CONTRIBUTING.md) for more information on how to contribute.
+We welcome community contributions to help achieve these goals! See [CONTRIBUTING.md](CONTRIBUTING.md) for more information on how to contribute.