docs: fix all markdownlint errors and add lint:docs task

CONTRIBUTING.md:
- Use 1. for all ordered list items (MD029 style=one)
- Add blank lines around every fenced code block inside list items (MD031)
- Add language specifier to bare fences: text for commit examples (MD040)
- Fix table pipe spacing to use compact style with spaces (MD060)

README.md:
- Use 1. for all ordered list items in token setup section (MD029)

.pre-commit-config.yaml:
- Add --ignore CHANGELOG.md to the markdownlint hook so commitizen-
  generated changelogs are not linted (their format is not configurable)

pyproject.toml:
- Add poe lint:docs task running markdownlint on all .md files
  excluding CHANGELOG.md

Author: zodiacfireworks

.pre-commit-config.yaml

@@ -12,6 +12,8 @@ repos:
         args:
           - --config
           - .markdownlint.yml
+          - --ignore
+          - CHANGELOG.md
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.15.6

CONTRIBUTING.md

@@ -5,21 +5,25 @@ This document explains how to contribute to the edit-python.pe project, the comm
 ## 🤝 How to Contribute
 
 1. Make sure to find an open issue on [GitHub](https://github.com/pythonpe/edit-python.pe/issues).
-2. Fork the [edit-python.pe](https://github.com/pythonpe/edit-python.pe) repository.
-3. Clone the forked repository to your local machine.
-4. Install [`uv`](https://docs.astral.sh/uv/getting-started/installation/).
-5. Install dependencies:
+1. Fork the [edit-python.pe](https://github.com/pythonpe/edit-python.pe) repository.
+1. Clone the forked repository to your local machine.
+1. Install [`uv`](https://docs.astral.sh/uv/getting-started/installation/).
+1. Install dependencies:
+
    ```bash
    uv sync
    ```
-6. Install the pre-commit hooks (enforces conventional commits and quality checks):
+
+1. Install the pre-commit hooks (enforces conventional commits and quality checks):
+
    ```bash
    uv run pre-commit install --hook-type commit-msg
    uv run pre-commit install
    ```
-7. Make your changes and cover them with tests.
-8. Push your changes to the forked repository.
-9. Open a pull request on [GitHub](https://github.com/pythonpe/edit-python.pe/pulls).
+
+1. Make your changes and cover them with tests.
+1. Push your changes to the forked repository.
+1. Open a pull request on [GitHub](https://github.com/pythonpe/edit-python.pe/pulls).
 
 ## 🚀 Development Commands
 
@@ -28,20 +32,21 @@ We use `poethepoet` (poe) as our task runner. Run the following commands as need
 - `uv run poe lint`: Runs the `ruff` linter (and checks types using `ty`).
 - `uv run poe lint:format`: Formats the code using `ruff format`.
 - `uv run poe lint:types`: Checks types using `ty check`.
+- `uv run poe lint:docs`: Lints Markdown files using `markdownlint` (excludes `CHANGELOG.md`).
 - `uv run poe test`: Runs the test coverage with `pytest`.
 
 ## 📝 Commit Style (Conventional Commits)
 
 This project enforces [Conventional Commits](https://www.conventionalcommits.org/) via a pre-commit hook powered by [Commitizen](https://commitizen-tools.github.io/commitizen/). Every commit message **must** follow this format:
 
-```
+```text
 <type>(<optional scope>): <short description>
 ```
 
 Allowed types:
 
 | Type | When to use |
-|------|-------------|
+| ------- | ------------------------------------------------------------ |
 | `feat` | A new feature |
 | `fix` | A bug fix |
 | `docs` | Documentation only changes |
@@ -54,7 +59,8 @@ Allowed types:
 | `chore` | Other changes that don't modify source or test files |
 
 **Examples:**
-```
+
+```text
 feat(auth): add GitHub OAuth login
 fix(markdown): handle missing homepage field gracefully
 docs: update README with uvx usage

README.md

@@ -28,8 +28,8 @@ Next, you'll be prompted for your access token and then you can seamlessly edit
 To interact with the repository and submit your profile, you will need a GitHub Personal Access Token.
 
 1. Generate a [Personal access token (classic)](https://github.com/settings/tokens).
-2. **Required Scopes**: Grant the `user` and `repo` scopes.
-3. Copy the token and keep it handy.
+1. **Required Scopes**: Grant the `user` and `repo` scopes.
+1. Copy the token and keep it handy.
 
 ## 🤝 Contribute
 

pyproject.toml

@@ -77,6 +77,7 @@ build-backend = "uv_build"
 "lint" = "uv run ruff check --fix"
 "lint:format" = "uv run ruff format"
 "lint:types" = "uv run ty check"
+"lint:docs" = { shell = "markdownlint '**/*.md' --ignore CHANGELOG.md --config .markdownlint.yml" }
 "test" = "uv run pytest --cov edit_python_pe --cov-report xml:cobertura.xml --cov-report term --junitxml report.xml"
 "freeze" = "uv export --format requirements.txt --no-group dev --no-hashes --no-annotate --no-header --output-file requirements.txt"
 "freeze:dev" = "uv export --format requirements.txt --all-groups --no-hashes --no-annotate --no-header --output-file requirements.dev.txt"