How to use .md files with !include

[mjawbt]

Question

I'm trying to structure my files a little bit and split big files into smaller ones for readability purpose. I'm facing an issue and not sure if this is due to bad usage from my side.

Here is the structure I use so far:

• workspace.dsl
• models/
  • system1/
    • system1.dsl
    • docs/
      • system1.md
  • system2/
  • ...

The thing is if I !include models inside workspace.dsl it try to interpret the .md files and throw error.

structurizr validate -w .\workspace.dsl
Unexpected tokens (expected: enterprise, group, person, softwareSystem, deploymentEnvironment, element, ->) at line 1: test at line 3: !include models

If I include each system dsl one by one it works.

Files attached in .zip
workspace.zip

Should I change the structure of my project or is there a way to "ignore" .md files ?

[simonbrowndotje]

Should I change the structure of my project or is there a way to "ignore" .md files ?

There's currently no way to ignore a set of files, so changing your directory structure (or including each file individually) would be the quickest way to move forward. That said, the general recommendation is that a workspace only includes the description and documentation for a single software system -> https://structurizr.com/help/usage-recommendations

[mjawbt]

Thank you very much for your answer.
The software systems being pretty small, not microservice but as small as possible and working together, I thought keeping them together was possible.
See the general recommendation:

It's also possible, particularly for smaller software systems, to merge all of the diagrams and documentation for a number of software systems into a single workspace.

Does this mean merging all documentations into one ?

Wouldn't it be possible to not have .md file interpreted as they are not .dsl files ?