# Is it possible to include files in Commonmark?

**URL:** <https://talk.commonmark.org/t/is-it-possible-to-include-files-in-commonmark/4128>\
**Category:** Extensions\
**Created:** [April 21, 2022, 11:51am UTC](https://talk.commonmark.org/t/is-it-possible-to-include-files-in-commonmark/4128 "2022-04-21T11:51:12Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![anon20778841](https://cdn.commonmark.org/letter_avatar_proxy/v2/letter/a/8e7dd6/32.png) [@anon20778841](https://talk.commonmark.org/u/anon20778841)\
**Post date:** [April 21, 2022, 11:51am UTC](https://talk.commonmark.org/t/is-it-possible-to-include-files-in-commonmark/4128/1 "2022-04-21T11:51:13Z")

</div>

#### feature name

Include files in Commonmark

#### feature description

I would like commonmark to have the possibility to include files markdown

#### sample 1

```auto
# Headline

Text

[include](File:load_another_md_file_here.md)

```

#### sample 2: test1.md

```auto
Something in markdown file!

```

#### sample 2: test2.md

```auto
#include "test1.md"

```

#### references

- [Include file-content as part of markdown. · Issue #346 · github/markup · GitHub](https://github.com/github/markup/issues/346)
- [https://stackoverflow.com/questions/35080160/github-include-md-files-in-readme-md](https://stackoverflow.com/questions/35080160/github-include-md-files-in-readme-md)
- [Support include of markdown files · Issue #777 · mkdocs/mkdocs · GitHub](https://github.com/mkdocs/mkdocs/issues/777)
- [GitHub - cmacmackin/markdown-include: Provides syntax for Python-Markdown which allows for the inclusion of the contents of other Markdown documents.](https://github.com/cmacmackin/markdown-include/)
- [GitHub - sethen/markdown-include: 📃 Include markdown files into other markdown files with C style syntax](https://github.com/sethen/markdown-include)
- [GitHub - camelaissani/markdown-it-include: Markdown-it plugin which adds the ability to include markdown fragment files](https://github.com/camelaissani/markdown-it-include)
- [GitHub - DCsunset/pandoc-include: A pandoc filter to allow file and header inclusion](https://github.com/DCsunset/pandoc-include)
- [GitHub - Kevenin/Markdown-Include: Adds Functionalityr to VsCode to create an .md file from multiple md files](https://github.com/Kevenin/Markdown-Include)
- [GitHub - neurobin/mdx\_include: Python Markdown extension to include local or remote files](https://github.com/neurobin/mdx_include)
- [https://github.com/georgemathieson/blazor-markdown](https://github.com/georgemathieson/blazor-markdown)
- [GitHub - IBM/md-includes: Project to allow includes in markdown files](https://github.com/IBM/md-includes)
- [GitHub - simonrenger/markdown-include-lines: This is a markdown extension for python which allows you to include lines of a whole source file.](https://github.com/simonrenger/markdown-include-lines)
- [GitHub - tomdalling/jekyll-include\_snippet: Include snippets of text from external files into your markdown](https://github.com/tomdalling/jekyll-include_snippet)

---

<div class="post-metadata">

**Author:** ![chrisalley](https://cdn.commonmark.org/user_avatar/talk.commonmark.org/chrisalley/32/906_2.png) [@chrisalley](https://talk.commonmark.org/u/chrisalley)\
**Post date:** [April 22, 2022, 11:32pm UTC](https://talk.commonmark.org/t/is-it-possible-to-include-files-in-commonmark/4128/2 "2022-04-22T23:32:01Z")

</div>

This isn’t part of the core spec, but there is a topic to discuss a file transclusion extension:

> [@Transclusion or including sub-documents for reuse](https://talk.commonmark.org/t/transclusion-or-including-sub-documents-for-reuse/270/):
>
> Coming from Foswiki, and now working on Docker documentation in markdown, I stongly miss having built in transclusion. If there’s any chance something basic can be included in Standrd Markdown - ala [http://fletcher.github.io/MultiMarkdown-4/transclusion](http://fletcher.github.io/MultiMarkdown-4/transclusion) that would be awesome - copy and paste is such a painfully pointless excercise…

---

<div class="post-metadata">

**Author:** ![anon20778841](https://cdn.commonmark.org/letter_avatar_proxy/v2/letter/a/8e7dd6/32.png) [@anon20778841](https://talk.commonmark.org/u/anon20778841)\
**Post date:** [April 24, 2022, 4:27am UTC](https://talk.commonmark.org/t/is-it-possible-to-include-files-in-commonmark/4128/3 "2022-04-24T04:27:48Z")

</div>

@chrisalley Hi! How are you? So… thank you for feedback

---

<div class="post-metadata">

**Author:** ![vas](https://cdn.commonmark.org/user_avatar/talk.commonmark.org/vas/32/1267_2.png) [@vas](https://talk.commonmark.org/u/vas)\
**Post date:** [April 26, 2022, 6:01pm UTC](https://talk.commonmark.org/t/is-it-possible-to-include-files-in-commonmark/4128/4 "2022-04-26T18:01:21Z")

</div>

You might find [Markdown and including multiple files](https://stackoverflow.com/questions/4779582/markdown-and-including-multiple-files) on StackOverflow useful.

It appears to be [a long running want-to-have for Pandoc](https://github.com/jgm/pandoc/issues/553).

I’m pretty sure some Static Site Generators support such inclusion using proprietary syntax extensions.

---

<div class="post-metadata">

**Author:** ![anon20778841](https://cdn.commonmark.org/letter_avatar_proxy/v2/letter/a/8e7dd6/32.png) [@anon20778841](https://talk.commonmark.org/u/anon20778841)\
**Post date:** [April 27, 2022, 4:22am UTC](https://talk.commonmark.org/t/is-it-possible-to-include-files-in-commonmark/4128/5 "2022-04-27T04:22:28Z")

</div>

> [@anon20778841](#):
>
> thank you for feedback

thank you so much… ^^ you are amazing

---

<div class="post-metadata">

**Author:** ![vas](https://cdn.commonmark.org/user_avatar/talk.commonmark.org/vas/32/1267_2.png) [@vas](https://talk.commonmark.org/u/vas)\
**Post date:** [July 20, 2023, 12:50pm UTC](https://talk.commonmark.org/t/is-it-possible-to-include-files-in-commonmark/4128/6 "2023-07-20T12:50:15Z")

</div>

IA Writer introduced [transclusion support in IA Writer 4](https://ia.net/topics/ia-writer-4) in late 2016. They even [wrote a spec for it with the hope for community adoption](https://github.com/iainc/Markdown-Content-Blocks).
