Skip to content

Enable MD001: Fix heading level increments for accessibility#2189

Merged
adegeo merged 3 commits intomainfrom
copilot/fix-md001-heading-levels
Feb 20, 2026
Merged

Enable MD001: Fix heading level increments for accessibility#2189
adegeo merged 3 commits intomainfrom
copilot/fix-md001-heading-levels

Conversation

Copy link
Contributor

Copilot AI commented Feb 4, 2026

MD001 was disabled, allowing 255 instances where heading levels skip increments (e.g., H1→H3). This breaks screen reader navigation and document structure.

@BillWagner

Fixes #2194

EDIT; Ack, wrong issue...
Fixes #29

Changes

  • Fixed 255 heading level violations across 222 markdown files
  • Enabled MD001 in .markdownlint-cli2.jsonc

Example

Before:

# How to: Display Dialog Boxes

### To display a dialog box

After:

# How to: Display Dialog Boxes

## To display a dialog box

All heading hierarchies now increment by single levels (H1→H2→H3), ensuring proper document structure for assistive technologies.

Original prompt

This section details on the original issue you should resolve

<issue_title>MD001: Heading levels should only increment by one level at a time</issue_title>
<issue_description>Violations of this rule has accessibility-related concerns.

Click here to view a list of MD001 violations
##[error]dotnet-desktop-guide/winforms/advanced/com-interop-by-displaying-a-windows-form-shadow.md:30 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h3; Actual: h4]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-add-data-to-the-clipboard.md:31 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-align-drawn-text.md:15 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-arrange-mdi-child-forms.md:19 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-capture-user-input-from-a-printdialog-at-run-time.md:18 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-change-the-value-of-a-setting-between-application-sessions.md:12 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-change-the-value-of-an-existing-setting-at-design-time.md:12 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-choose-the-printers-attached-to-user-computer-in-windows-forms.md:18 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-complete-windows-forms-print-jobs.md:18 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-create-a-path-gradient.md:21 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-create-application-settings.md:19 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-create-graphics-objects-for-drawing.md:27 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h3; Actual: h4]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-create-graphics-objects-for-drawing.md:44 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h3; Actual: h4]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-create-graphics-objects-for-drawing.md:90 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h3; Actual: h4]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-create-graphics-objects-for-drawing.md:118 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h3; Actual: h4]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-create-graphics-objects-for-drawing.md:155 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h3; Actual: h4]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-create-standard-windows-forms-print-jobs.md:17 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-determine-the-active-mdi-child.md:22 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-draw-cardinal-splines.md:16 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-draw-text-at-a-specified-location.md:23 MD001/heading-increment/header-increment Heading levels should only increment by one level at a time [Expected: h2; Actual: h3]
##[error]dotnet-desktop-guide/winforms/advanced/how-to-draw-wrapped-text-in-a-rectangle.md:22 MD001/heading-increment/header-increment Heading levels should only...

</details>



<!-- START COPILOT CODING AGENT SUFFIX -->

- Fixes dotnet/docs-desktop#29

<!-- START COPILOT CODING AGENT TIPS -->
---

✨ Let Copilot coding agent [set things up for you](https://github.com/dotnet/docs-desktop/issues/new?title=✨+Set+up+Copilot+instructions&body=Configure%20instructions%20for%20this%20repository%20as%20documented%20in%20%5BBest%20practices%20for%20Copilot%20coding%20agent%20in%20your%20repository%5D%28https://gh.io/copilot-coding-agent-tips%29%2E%0A%0A%3COnboard%20this%20repo%3E&assignees=copilot) — coding agent works faster and does higher quality work when set up for your repo.


<!-- PREVIEW-TABLE-START -->

---

#### Internal previews

<details><summary><strong>Toggle expand/collapse</strong></summary><br/>

| 📄 File | 🔗 Preview link |
|:--|:--|
| [dotnet-desktop-guide/winforms/advanced/com-interop-by-displaying-a-windows-form-shadow.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/com-interop-by-displaying-a-windows-form-shadow.md) | [dotnet-desktop-guide/winforms/advanced/com-interop-by-displaying-a-windows-form-shadow](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/com-interop-by-displaying-a-windows-form-shadow?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-align-drawn-text.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-align-drawn-text.md) | [dotnet-desktop-guide/winforms/advanced/how-to-align-drawn-text](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-align-drawn-text?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-arrange-mdi-child-forms.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-arrange-mdi-child-forms.md) | [dotnet-desktop-guide/winforms/advanced/how-to-arrange-mdi-child-forms](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-arrange-mdi-child-forms?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-change-the-value-of-a-setting-between-application-sessions.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-change-the-value-of-a-setting-between-application-sessions.md) | [dotnet-desktop-guide/winforms/advanced/how-to-change-the-value-of-a-setting-between-application-sessions](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-change-the-value-of-a-setting-between-application-sessions?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-change-the-value-of-an-existing-setting-at-design-time.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-change-the-value-of-an-existing-setting-at-design-time.md) | [dotnet-desktop-guide/winforms/advanced/how-to-change-the-value-of-an-existing-setting-at-design-time](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-change-the-value-of-an-existing-setting-at-design-time?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-choose-the-printers-attached-to-user-computer-in-windows-forms.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-choose-the-printers-attached-to-user-computer-in-windows-forms.md) | [dotnet-desktop-guide/winforms/advanced/how-to-choose-the-printers-attached-to-user-computer-in-windows-forms](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-choose-the-printers-attached-to-user-computer-in-windows-forms?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-create-a-path-gradient.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-create-a-path-gradient.md) | [dotnet-desktop-guide/winforms/advanced/how-to-create-a-path-gradient](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-create-a-path-gradient?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-create-application-settings.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-create-application-settings.md) | [dotnet-desktop-guide/winforms/advanced/how-to-create-application-settings](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-create-application-settings?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-create-graphics-objects-for-drawing.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-create-graphics-objects-for-drawing.md) | [dotnet-desktop-guide/winforms/advanced/how-to-create-graphics-objects-for-drawing](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-create-graphics-objects-for-drawing?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-determine-the-active-mdi-child.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-determine-the-active-mdi-child.md) | [dotnet-desktop-guide/winforms/advanced/how-to-determine-the-active-mdi-child](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-determine-the-active-mdi-child?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-draw-cardinal-splines.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-draw-cardinal-splines.md) | [dotnet-desktop-guide/winforms/advanced/how-to-draw-cardinal-splines](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-draw-cardinal-splines?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-draw-text-at-a-specified-location.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-draw-text-at-a-specified-location.md) | [dotnet-desktop-guide/winforms/advanced/how-to-draw-text-at-a-specified-location](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-draw-text-at-a-specified-location?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-draw-wrapped-text-in-a-rectangle.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-draw-wrapped-text-in-a-rectangle.md) | [dotnet-desktop-guide/winforms/advanced/how-to-draw-wrapped-text-in-a-rectangle](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-draw-wrapped-text-in-a-rectangle?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-flatten-a-curved-path-into-a-line.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-flatten-a-curved-path-into-a-line.md) | [dotnet-desktop-guide/winforms/advanced/how-to-flatten-a-curved-path-into-a-line](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-flatten-a-curved-path-into-a-line?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-manually-manage-buffered-graphics.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-manually-manage-buffered-graphics.md) | [dotnet-desktop-guide/winforms/advanced/how-to-manually-manage-buffered-graphics](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-manually-manage-buffered-graphics?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/how-to-manually-render-buffered-graphics.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/how-to-manually-render-buffered-graphics.md) | [dotnet-desktop-guide/winforms/advanced/how-to-manually-render-buffered-graphics](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/how-to-manually-render-buffered-graphics?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/walkthrough-creating-an-accessible-windows-based-application.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/walkthrough-creating-an-accessible-windows-based-application.md) | [dotnet-desktop-guide/winforms/advanced/walkthrough-creating-an-accessible-windows-based-application](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/walkthrough-creating-an-accessible-windows-based-application?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/advanced/walkthrough-performing-a-drag-and-drop-operation-in-windows-forms.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/advanced/walkthrough-performing-a-drag-and-drop-operation-in-windows-forms.md) | [dotnet-desktop-guide/winforms/advanced/walkthrough-performing-a-drag-and-drop-operation-in-windows-forms](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/advanced/walkthrough-performing-a-drag-and-drop-operation-in-windows-forms?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/controls/creating-a-master-detail-form-using-two-datagridviews.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/controls/creating-a-master-detail-form-using-two-datagridviews.md) | [dotnet-desktop-guide/winforms/controls/creating-a-master-detail-form-using-two-datagridviews](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/controls/creating-a-master-detail-form-using-two-datagridviews?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/controls/creating-an-explorer-style-interface-with-the-listview-and-treeview.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/controls/creating-an-explorer-style-interface-with-the-listview-and-treeview.md) | [dotnet-desktop-guide/winforms/controls/creating-an-explorer-style-interface-with-the-listview-and-treeview](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/controls/creating-an-explorer-style-interface-with-the-listview-and-treeview?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid.md) | [dotnet-desktop-guide/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/controls/how-to-control-the-insertion-point-in-a-windows-forms-textbox-control.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/controls/how-to-control-the-insertion-point-in-a-windows-forms-textbox-control.md) | [dotnet-desktop-guide/winforms/controls/how-to-control-the-insertion-point-in-a-windows-forms-textbox-control](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/controls/how-to-control-the-insertion-point-in-a-windows-forms-textbox-control?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md) | [dotnet-desktop-guide/winforms/controls/implementing-virtual-mode-wf-datagridview-control](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/controls/implementing-virtual-mode-wf-datagridview-control?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/controls/link-to-an-object-or-web-page-with-wf-linklabel-control.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/controls/link-to-an-object-or-web-page-with-wf-linklabel-control.md) | [dotnet-desktop-guide/winforms/controls/link-to-an-object-or-web-page-with-wf-linklabel-control](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/controls/link-to-an-object-or-web-page-with-wf-linklabel-control?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md) | [dotnet-desktop-guide/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md) | [dotnet-desktop-guide/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/winforms/controls/walkthrough-working-with-the-maskedtextbox-control.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/winforms/controls/walkthrough-working-with-the-maskedtextbox-control.md) | [dotnet-desktop-guide/winforms/controls/walkthrough-working-with-the-maskedtextbox-control](https://review.learn.microsoft.com/en-us/dotnet/desktop/winforms/controls/walkthrough-working-with-the-maskedtextbox-control?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/wpf/advanced/how-to-enable-visual-styles-in-a-hybrid-application.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/wpf/advanced/how-to-enable-visual-styles-in-a-hybrid-application.md) | [dotnet-desktop-guide/wpf/advanced/how-to-enable-visual-styles-in-a-hybrid-application](https://review.learn.microsoft.com/en-us/dotnet/desktop/wpf/advanced/how-to-enable-visual-styles-in-a-hybrid-application?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/wpf/advanced/walkthrough-caching-application-data-in-a-wpf-application.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/wpf/advanced/walkthrough-caching-application-data-in-a-wpf-application.md) | [dotnet-desktop-guide/wpf/advanced/walkthrough-caching-application-data-in-a-wpf-application](https://review.learn.microsoft.com/en-us/dotnet/desktop/wpf/advanced/walkthrough-caching-application-data-in-a-wpf-application?branch=pr-en-us-2189) |
| [dotnet-desktop-guide/wpf/advanced/walkthrough-creating-direct3d9-content-for-hosting-in-wpf.md](https://github.com/dotnet/docs-desktop/blob/dbc3a117d5ac492786460590bf4ddc2d862a593c/dotnet-desktop-guide/wpf/advanced/walkthrough-creating-direct3d9-content-for-hosting-in-wpf.md) | [dotnet-desktop-guide/wpf/advanced/walkthrough-creating-direct3d9-content-for-hosting-in-wpf](https://review.learn.microsoft.com/en-us/dotnet/desktop/wpf/advanced/walkthrough-creating-direct3d9-content-for-hosting-in-wpf?branch=pr-en-us-2189) |

</details>

> [!NOTE]
> This table shows preview links for the 30 files with the most changes. For preview links for other files in this PR, select <strong>OpenPublishing.Build Details</strong> within [checks](https://github.com/dotnet/docs-desktop/pull/2189/checks).


<!-- PREVIEW-TABLE-END -->

Co-authored-by: adegeo <67293991+adegeo@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix MD001 violations for heading levels Enable MD001: Fix heading level increments for accessibility Feb 4, 2026
Copilot AI requested a review from adegeo February 4, 2026 21:11
@adegeo adegeo marked this pull request as ready for review February 17, 2026 20:18
Copilot AI review requested due to automatic review settings February 17, 2026 20:18
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request fixes accessibility violations by correcting 255 instances where markdown heading levels skip increments (e.g., H1→H3 instead of H1→H2→H3), which breaks screen reader navigation. The fix ensures all heading hierarchies increment by single levels across 222 markdown files and enables the MD001 linting rule to prevent future violations.

Changes:

  • Fixed heading level violations across 222 markdown files by converting H3 to H2 and H4 to H3 where appropriate
  • Enabled MD001 rule in .markdownlint-cli2.jsonc with accessibility comment
  • Ensured proper document structure for assistive technologies

Reviewed changes

Copilot reviewed 223 out of 223 changed files in this pull request and generated no comments.

File Description
.markdownlint-cli2.jsonc Enabled MD001 rule to enforce proper heading level increments
Multiple markdown files (222 total) Corrected heading levels from H3→H2 or H4→H3 to maintain proper hierarchy

@adegeo adegeo force-pushed the copilot/fix-md001-heading-levels branch from bc330cc to 0c05b95 Compare February 17, 2026 22:07
@adegeo adegeo enabled auto-merge (squash) February 17, 2026 23:27
@adegeo adegeo requested a review from BillWagner February 17, 2026 23:38
Thraka
Thraka previously approved these changes Feb 17, 2026
Copy link
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This LGTM @adegeo

Let's :shipit:

@adegeo adegeo merged commit 5cf9fef into main Feb 20, 2026
9 checks passed
@adegeo adegeo deleted the copilot/fix-md001-heading-levels branch February 20, 2026 14:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Fix MD001: Fix heading level increments for accessibility violations MD001: Heading levels should only increment by one level at a time

6 participants