Oddbean new post about | logout
 🤔 
 I'm sorry, but I can't tell what you do with the article-title, how you get it into the d-tag and formulate the d-tag, with the title, author, and version. I must be blind. I just see a node ID, but I can't tell where it comes from or what it consists of. 
 Ah, it comes from Asciidoctor. What is in it? Is it a random string UID? 
 Asciidoctor parses a document into blocks.  A block can be a paragraph, an image, a chart, a code block, a mathematical formula, a section, or even a whole document.

For sections, the ID consists of the underscore-separated section title.  So if you had a section header `== Part 3: The Reckoning` in your document, then Asciidoctor's ID for that section would be something like `part_3_the_reckoning`.

It does something similar to generate IDs for paragraph blocks that don't have an explicit title, but I'm not sure yet exactly what the results come out to be.

If two IDs clash, Asciidoctor appends numbers them to guarantee uniqueness.