feat: add markdownlint integration for consistent documentation quality (#10)

* feat: add editorconfig focused on Python backend development (#8)

- Add Python configuration with 4-space indentation and 200-char line length
- Configure YAML/JSON files with 2-space indentation
- Add Markdown configuration with UTF-8 encoding, preserve trailing whitespace
- Add TOML configuration for config files
- Remove JavaScript/TypeScript frontend configurations to focus on backend needs
- Ensure consistent formatting across all project file types

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Claude <[email protected]>

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: Claude <[email protected]>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: 3 people

.markdownlint.yaml

@@ -0,0 +1,67 @@
+# Markdownlint configuration for markdown-flow-agent-py
+# See https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
+
+# Default state for all rules
+default: true
+
+# Line length - disabled as it can affect readability
+MD013: false
+
+# Heading style
+MD003:
+  style: "atx"
+
+# Unordered list style
+MD004:
+  style: "dash"
+
+# Ordered list item prefix
+MD029:
+  style: "ordered"
+
+# Code block style
+MD046:
+  style: "fenced"
+
+# Emphasis style
+MD049:
+  style: "underscore"
+
+# Strong style
+MD050:
+  style: "asterisk"
+
+# Allow inline HTML (needed for some advanced formatting)
+MD033: false
+
+# Allow bare URLs (common in documentation)
+MD034: false
+
+# First line in file should be a top level heading (not always needed)
+MD041: false
+
+# No duplicate headings (allow with different nesting)
+MD024:
+  siblings_only: true
+  allow_different_nesting: true
+
+# No trailing punctuation in headings
+# Allow question marks for FAQ-style headings
+MD026:
+  punctuation: ".,;:!"
+
+# Allow multiple top-level headings (for documentation)
+MD025: false
+
+# Allow emphasis as heading (disable MD036 for flexibility)
+MD036: false
+
+# Ignore files
+exclude:
+  - "node_modules/**"
+  - ".git/**"
+  - ".mypy_cache/**"
+  - ".ruff_cache/**"
+  - "*.egg-info/**"
+  - "build/**"
+  - "dist/**"

.pre-commit-config.yaml

@@ -47,6 +47,16 @@ repos:
         description: Ensures test files are named correctly
         args: [--pytest-test-first]
 
+  # =============================================================================
+  # Markdown linting
+  # =============================================================================
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.45.0
+    hooks:
+      - id: markdownlint
+        description: Lint and format markdown files
+        args: ["--fix"]
+
   # =============================================================================
   # Python code formatting and linting (Ruff - modern replacement for Black/Flake8/isort)
   # =============================================================================