diff --git a/pyproject.toml b/pyproject.toml
index f20ba2b..6751e32 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -37,6 +37,8 @@ packages = ["src/ccn_transcribe"]
 [tool.ruff]
 line-length = 100
 src = ["src", "tests"]
+# ruff format also restyles Python blocks inside Markdown; docs are not ours to restyle.
+extend-exclude = ["*.md"]
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I", "N", "UP", "B", "A", "C4", "SIM", "PTH", "RET", "ARG", "TID", "TC", "RUF"]
@@ -54,6 +56,9 @@ venv = ".venv"
 strict = true
 files = ["src", "tests"]
 
+[tool.pylint.design]
+max-attributes = 10
+
 [tool.pylint.main]
 disable = ["C0114", "C0115", "C0116", "C0301", "W0611", "W0612", "R0801"]