From 82e3c39585d38878f276aaad314da2ff2d8d9e35 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Kuna?=
 <1282324+codecalm@users.noreply.github.com>
Date: Sun, 11 Jan 2026 17:24:23 +0100
Subject: [PATCH] Enhance markdown typography configuration (#2590)

---
 .cursor/rules/branch-naming.mdc | 38 +++++++++++++++++++++++++++++++++
 core/scss/_variables.scss       |  5 +++++
 core/scss/ui/_markdown.scss     |  6 +++++-
 3 files changed, 48 insertions(+), 1 deletion(-)
 create mode 100644 .cursor/rules/branch-naming.mdc

diff --git a/.cursor/rules/branch-naming.mdc b/.cursor/rules/branch-naming.mdc
new file mode 100644
index 000000000..1275ffa6b
--- /dev/null
+++ b/.cursor/rules/branch-naming.mdc
@@ -0,0 +1,38 @@
+---
+description: Git Branch Naming Rules
+globs:
+alwaysApply: true
+---
+
+## Branch naming
+
+- Use lowercase branch names.
+- Use a type prefix and a short description in kebab-case.
+- Format: `<type>/<short-description>` or `<type>/<issue-id>-<short-description>`
+- Use `gh-123` as the issue id format (avoid `#` in branch names).
+
+### Allowed types
+
+- `feat` - new features
+- `fix` - bug fixes
+- `docs` - documentation changes
+- `chore` - maintenance / tooling
+- `refactor` - code refactoring (no behavior change)
+- `test` - tests only
+- `build` - build system changes
+- `ci` - CI changes
+- `perf` - performance improvements
+- `style` - formatting / lint-only changes
+- `revert` - reverting prior changes
+
+### Examples
+
+- `feat/gh-123-add-stepper-component`
+- `fix/markdown-table-overflow`
+- `docs/gh-45-update-contributing`
+- `chore/update-pnpm-lock`
+
+### Notes
+
+- Branch off `dev` by default (unless maintainers request otherwise).
+- Avoid spaces, uppercase letters, and special characters other than `/` and `-`.
diff --git a/core/scss/_variables.scss b/core/scss/_variables.scss
index f6230e1df..ab8ada47e 100644
--- a/core/scss/_variables.scss
+++ b/core/scss/_variables.scss
@@ -495,6 +495,11 @@ $line-heights: (
   h4: $h4-line-height,
   h5: $h5-line-height,
   h6: $h6-line-height,
+
+  base: $line-height-base,
+  sm: $line-height-sm,
+  lg: $line-height-lg,
+  xl: $line-height-xl,
 ) !default;
 
 $display-font-sizes: (
diff --git a/core/scss/ui/_markdown.scss b/core/scss/ui/_markdown.scss
index 51b7d5f35..654b58e8b 100644
--- a/core/scss/ui/_markdown.scss
+++ b/core/scss/ui/_markdown.scss
@@ -1,8 +1,12 @@
+$markdown-font-size: var(--#{$prefix}font-size-h3) !default;
+$markdown-line-height: var(--#{$prefix}line-height-lg) !default;
+
 /**
 Markdown
  */
 .markdown {
-  line-height: $line-height-xl;
+  line-height: $markdown-line-height;
+  font-size: $markdown-font-size;
 
   > :first-child {
     margin-top: 0;