Problem to Solve
Single-source approach for docs-as-code strongly recommends not to use copy and paste for content, but to have content written once and used multiple times. To do that we need to be able to use content from another markdown file.
Current Workaround
Just copy and paste the content.
Proposed Solution
Implement the include function.
With the optional ability to include not the whole file but only a part of it (usually implemented by tags in the source file, that are not visible in the rendered version of docs).
Additional Information
This is widely used in Asciidoc and ReStructuredText but not so much in Markdown. Mostly because default markdown does not support this.
Problem to Solve
Single-source approach for docs-as-code strongly recommends not to use copy and paste for content, but to have content written once and used multiple times. To do that we need to be able to use content from another markdown file.
Current Workaround
Just copy and paste the content.
Proposed Solution
Implement the include function.
With the optional ability to include not the whole file but only a part of it (usually implemented by tags in the source file, that are not visible in the rendered version of docs).
Additional Information
This is widely used in Asciidoc and ReStructuredText but not so much in Markdown. Mostly because default markdown does not support this.