Block references are a feature of [[Obsidian]], but not included in the [[Markdown]] spec. There isn't a spec I've found that shows explicitly what syntaxes work and don't work for block references for markdown linking & [[Transclusion]]s, so I played around with all the variations I could think of. This is that.
---
These two lines are considered one block.
Doesn't matter if this is indented or not.
^blockOne
This block ID is not recognized as valid → ^blockTwo
Because it's not at the end of the block...
...but shifting it to the end of the last line does work.
This works the same as the first paragraph ^blockThree
- Bullets are treated as independent blocks ^blockFour
- Even back-to-back bullets are independent ^blockFive
- But indentions are recognized as part of the higher block
- Even if they have their own block ref ^blockSix
- ==This sub bullet== is a part of block six, which itself is a part of block five (but not block four)
```plaintext
Block IDs in codeblocks are not valid ^blockSeven
```
```plaintext
But block IDs placed at the end of codeblocks
will recognize the whole code block
Even if it has line breaks and stuff.
But cannot have the blockID on the same line as the "```" delimiter
```
^blockEight
> blockquotes function the same way as codeblocks. ^blockNine
> Other than you can include the block ID on the last line ^blockTen
Blank lines between your paragraph and the block ID are ignored. So this is referenced as block eleven despite the empty line.
^blockEleven
If your blockID is on the subsequent line, it **has** to be the **whole** line.
^blockTwelve ← is ruined as a blockID by this text
Block IDs can contain "Latin letters, numbers, and dashes".
^block-13
Block IDs actually _block_ other block IDs from working. Ironic.
^blockFourteen
^blockFifteen
1. Ordered lists ^blockSixteen
2. Act the same as unordered lists ^blockSeventeen
3. Interestingly, if you leave a blank space after a list, then include a block ID, the block ID will point to the whole list.
^blockEighteen
| Tables | Work | Only | As | A | Whole |
| ------ | ------ | ---- | ---------- | ----- | ---------------- |
| You | cannot | grab | individual | cells | . ^blockNineteen |
^blockTwenty
---
> [!tip] The following block reference [[Transclusion]]s illustrate what works & what doesn't
![[Obsidian Block References#^blockOne]]
![[Obsidian Block References#^blockTwo]]
![[Obsidian Block References#^blockThree]]
![[Obsidian Block References#^blockFour]]
![[Obsidian Block References#^blockFive]]
![[Obsidian Block References#^blockSix]]
![[Obsidian Block References#^blockSeven]]
![[Obsidian Block References#^blockEight]]
![[Obsidian Block References#^blockNine]]
![[Obsidian Block References#^blockTen]]
![[Obsidian Block References#^blockEleven]]
![[Obsidian Block References#^blockTwelve]]
![[Obsidian Block References#^block-13]]
![[Obsidian Block References#^blockFourteen]]
![[Obsidian Block References#^blockFifteen]]
![[Obsidian Block References#^blockSixteen]]
![[Obsidian Block References#^blockSeventeen]]
![[Obsidian Block References#^blockEighteen]]
![[Obsidian Block References#^blockNineteen]]
![[Obsidian Block References#^blockTwenty]]
****
# More
## Source
- Playing around with it.
- https://help.obsidian.md/Linking+notes+and+files/Internal+links#Link+to+a+block+in+a+note
## Related
- [[Obsidian]]