Skip to content
This repository was archived by the owner on Nov 28, 2025. It is now read-only.
This repository was archived by the owner on Nov 28, 2025. It is now read-only.

Incorrect handling of @formatter:off and @formatter:on markers – misinterpreted as citations #317

Description

@distractor

Description

The plugin currently misinterprets @formatter:off and @formatter:on markers as citation references, which leads to a large number of warnings and severely degrades performance.

Steps to Reproduce

  1. Include the following block in a Markdown file:

    <!-- @formatter:off -->
    !!! info
        Some text here.
    <!-- @formatter:on -->
  2. Run the plugin.

Expected Behavior

The @formatter:off and @formatter:on comments should be ignored by the plugin and not interpreted as citations.

Actual Behavior

The plugin interprets @formatter:off as a citation reference (@formatter), which does not exist, leading to:

  • Numerous warning messages about missing citations
  • Significant slowdown in the processing

Suggested Solution

Introduce special handling for @formatter:off and @formatter:on to ensure they are treated as formatting directives only, not as citation markers.

OR maybe there is a nice mkdocs formatting tool I am not yet aware off. Nevertheless, whatever formatting Clion uses, is not OK, thus the requirement for @formatter:off and @formatter:on

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions