Hi, I needed to include the content of one markdown content file in another and it was suggested to me that the best way to do it would be with a custom shortcode. So I created a simple shortcode as follows {{ $file := .Get “file” | readFile }} {{ (print “\n” $file “\n”) | markdownify }} This do…

I believe this has open discussions in the forums and/or GitHub issues. I don’t recall there being a way due to how BlackFriday, the markdown processor, generates the document tree, or something. I don’t fully recall, but search for it, you’ll find the discussions. :slight_smile:

Thanks for the reply. I did do a search in the forums but didn’t find any specific discussion. I’ll check GitHub issues but from what you are mentioning, it looks like this wouldn’t be possible :worried: That seems a bit limiting. Are there any other alternative ways to achieve the same result ?

I was hoping that page resources would help you. But just tested, and the ToC only picks up headers from the original content file, not any of the page resource files.

There is an open issue about fixing this, and we will eventually get there.

Thanks for the update. Could you please point me to the issue. I would like to track it and if possible, contribute.

@darshakthakore my response to this post was moved to a separate tips-n-tricks post — Create a custom page TOC ("mini TOC") with Javascript (which I’ve now edited to match an independent tip) — so I’m not sure whether you had a chance to see it. As I had previously written, we’re in the process of i…

@sharonl thanks a lot for the response. I did check it and am trying it out now. Will report back on it but I really appreciate you providing the info. cheers.

Also note that I’m working on simplifying the “page and content etc.” part of Hugo’s source code to prepare for “Pages from data sources”, and I have this and other related issues in the back of my head while doing so.

Shortcode processing order

support

Topic		Replies	Views
The short code way of including md cause headings missed support	3	1182	November 20, 2023
Markdown read with the Docsy theme's readfile shortcode is not included in TOC support toc	11	1178	February 2, 2023
Include an md file support	16	15908	May 15, 2021
Extend .TableOfContents from within shortcode support	4	683	March 29, 2021
Include-file shortcode for including files with shortcode calls tips & tricks	0	4735	January 28, 2019

Shortcode processing order

Related topics