I’ve searched this topic but could not find any solution to what it seems to be it should be a pretty common need. I have several man pages of programs that share common options. For obvious reasons I would like to avoid having to copy the same text over and over again to each individual .md file (…

Simplest solution would be to just preprocess the files using a template language like Mustache, though it’s not always the most ideal solution. There appears to have been some discussion Transclusion or including sub-documents for reuse - #11 by chrisalley - Extensions - CommonMark Discussion abou…

@mike Thanks for the quick update on the situation but for me, only wanting to suffer horribly with docs, it seems easier to … drop Documenter and go back to RST.

@joa-quim : when working with Documenter.jl, the following worked for me for including a file “links.md”, located in docs/src/: ````@eval using Markdown Markdown.parse_file(joinpath("..", "src", "links.md")) `` ` Note: this will be evaluated in (a subfolder of) the build folder. So, you will need…

[image] samo: Is there a portable way to easily get to the root of the docs to avoid needing .. (something that will still work in all CI build scenarios etc.)? You can access Main (i.e. stuff in the make.jl script) from the at-blocks. So you should be able to do something like: Define a gl…

Thanks a lot @mortenpi ! That worked :slight_smile: You could even define it as a function to reduce the boilerplate in the at-eval block. Is it also possible to create a custom macro that one can call then instead of @eval? The use case would be to do, e.g., @_ref(StaticArrays.jl) inside a norm…

[image] samo: Is it also possible to create a custom macro that one can call then instead of @eval? Technically, yes, but it becomes a little non-trivial. You would have to look at how we implement the various at-blocks in the Expanders pipeline (side note: they have nothing to do with Julia …

Is there a way to include Markdown files inside other Markdown?

General Usage

samo July 14, 2022, 5:59pm 5

Note that I just opened a related topic: How to use Markdown reference links with Documenter.jl

Topic		Replies	Views
Make Documenter.jl understand where to search local markdown links General Usage documenter	5	1471	July 12, 2022
How to use Markdown reference links with Documenter.jl General Usage documenter , markdown	2	1641	October 31, 2022
Can documenter insert (embed) examples from a file to a page code block? Tooling documenter	2	402	March 11, 2021
Interpolate variables in markdown in Documenter.jl General Usage documentation , documenter , markdown	1	508	June 29, 2021
Documenter.jl: Linking to specific files and Documentation of Scripts General Usage documenter , literate-programming	3	2417	May 6, 2019

Is there a way to include Markdown files inside other Markdown?

Related topics