File import in CLAUDE.md
I have a question about file import in CLAUDE.md (or wherever it's supported): how does Claude handle markdown heading hierarchy when importing files?
Specifically, if I import a file that contains its own headings, are those headings inserted at the same level as they appear in the imported file, potentially breaking the intended document structure?
Let me explain with an example:
CLAUDE.md
# Project info
project information ...
# Code conventions
@conventions.md
conventions.md
# Main conventions
- Use DRY principles
Does the resultant prompt become:
# Project info
project information ...
# Code conventions
# Main conventions
- Use DRY principles
In this case, the imported file content would be structurally outside of the # Code conventions section, since # Main conventions becomes a top-level heading rather than a subsection. This breaks the intended document hierarchy where the conventions should be nested under the Code conventions section.
Is this how the import mechanism works, or does Claude automatically adjust heading levels to maintain proper document structure?
This issue has 13 comments on GitHub. Read the full discussion on GitHub ↗