Skip to content

Improve headline sizing flexibility in stepper component #693

@coderabbitai

Description

@coderabbitai

Context

This issue tracks feedback from PR #691 regarding headline sizing in the stepper component.

Problem

The current stepper component has hardcoded sizing for step titles, which can look problematic in certain scenarios:

  • H3 headers used for steps appear too large
  • Typically, content would have an H2 before the stepper, with H3 headers defining the steps
  • Using smaller headers (e.g., H4) to reduce size results in MyST warnings: WARNING: Non-consecutive header level increase; H1 to H4 [myst.header]

Potential Solution

Consider making step title sizes configurable, potentially by adding a parameter to the stepper directive to allow users to control the visual size independently of the actual heading level.

References

cc: @bmunkholm

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions