So, I have a page for the clipouts from books I read. The page is structured (rather poorly, I admit) like this:
# Book Name Goes Here
- #some-kind-of-hashtag
- ## Excerpts
- ### Thematic header
- Lorem impsum
- Dolor sit amet
The thing is: I can’t seem to be able to embed the heading with its content from another page using transclusions syntax. OK, so here’s my clipout (heavily redacted, cause copyrighted material):
- ### Make your own test
- 1. Create a new pipeline job in the **test** stage ...
2. Use the **images** keyword...
3. In the **script** ...
4. Add **allow\_failure: true** to your job...
5. The second part...
In theory, it should be embeddable with a quick ![[clipouts#Make your own test]], and, indeed, editor suggests that, but the transclusion comes up empty and I couldn’t make it work.
The more fundamental question is: how embedding with headers even works? The documentation says this
![[page name#header]] embed only a section (guarded by the given header)
but that doesn’t really clear up ambiguity in any way. Where precisely the header starts and where does it end? Does it continue till we hit another header of any level? Only the same level? What about text, does it have to be indented to fall into the header? How all of this jives with outlines?
Hmmm, on my end it seems like they work fine when there are no spaces in the heading name, but perhaps fail when there are spaces in it? In which case it might be a bug. Is that also true for you? Can you test and see if it works when you try to embed a single-word heading?
Nope, tried replacing spaces with underscores, didn’t work. Tried reducing the header to a single word — did not work either. Also, Transclusions page of documentation uses a bunch of transclusions with spaces in their headers, so it works for them.
The funny thing is — pressing “link” icon in transclusions box reliably sends me to that header, but the transclusion box itself is empty.
First, I’m not sure if headers inside of bulleted lists are actually even a thing that markdown supports. I have never seen this before, so if it does anything that’s by accident. SilverBullet itself for sure has no support for it. Headers are supposed to be top-level only.
First of all, thanks for chiming in and clarifying. I’m coming from Logseq and outlines with headers used to just work there, so I assumed it might work in SB as well. Outlines need headers and devising hacks to make text bold + increase its size + make this point in the outline linkable would be a huge pain point. Maybe I need to change my philosophy about this and just make a “core” document that embeds other chunks as transclusions, but even that is a hack in my opinion. I tried transcluding outlined headers and it works to some capacity: one would indeed get the section from the header to his next neighbor, but the markdown inside wouldn’t render. For example:
Header 1.1 embeds. Header 2.2 doesn’t. Why? I suspect because it’s the last non-top-level header of the document: there are no headers of the same level after it. If I go to test/source and remove one hash character from 2.2 to make it a top-level header — it embeds perfectly fine.
Just found that there’s already an open issue for this on GH, actually!
I mmmmight try later to see if I can find the bug? Thanks Zef for pointing out the section of the code that applies to this feature!
PS, sorry for my bad info thinking it was related to spaces in the name haha, guess it was just a coincidence that on my page the last header was the only one with a space in it. Thanks snake_case for the correction!
Huh, I should’ve checked github issues myself, so glad that it’s tracked already. Should I close the thread and mark your message as a solution? What’s the local policy on this?
