'doc' is undefined - when using the doc macro within a markdown file - is this expected?

Help
,
1

The problem I’m having

I cannot use the doc() macro in docs blocks. Is this intentionally?

The context of why I’m trying to do this

I want to modularize the documentation of the project overview, i.e. split the overview in multiple markdown files. And then include the parts in the main file via the doc() macro.

What I’ve already tried

Some example code or error messages

Markdown file:

{% docs my_id %}

{{ doc("another_id")}}

{% enddocs %}

Error message:

12:28:09  Encountered an error:
Compilation Error
  'doc' is undefined. This can happen when calling a macro that does not exist. Check for typos and/or install package dependencies with "dbt deps".