Giving a header an ID

[IngwiePhoenix]

Hey.

Will Parsedown ever support

# Heading {#some-id}

or similar?

Kind regards, Ingwie.

[hkdobrev]

@IngwiePhoenix This is a feature from Markdown Extra which Parsedown Extra supports.

[IngwiePhoenix]

Is it the same API? Or do I need to change anything in my code to use Parsedown Extra?

On Do. Apr. 02 2015 18:22:31 Haralan Dobrev wrote:

@IngwiePhoenix https://github.com/IngwiePhoenix This is a feature from Markdown Extra https://michelf.ca/projects/php-markdown/extra/#spe-attr which Parsedown Extra https://github.com/erusev/parsedown-extra supports.

—
Reply to this email directly or view it on GitHub #306 (comment).

[hkdobrev]

@IngwiePhoenix It's the same. It's just a simple extension of the Parsedown class. You just need to include the ParsedownExtra.php file (or if you are using Composer, just composer require erusev/parsedown-extra) and make an instance of the ParsedownExtra class.

[IngwiePhoenix]

Awesome. I just changed to ParsedownExtra on my project and its awesome. :) Thanks!

On Do. Apr. 02 2015 18:37:13 Haralan Dobrev wrote:

@IngwiePhoenix https://github.com/IngwiePhoenix It's the same. It's just a simple extension of the Parsedown class. You just need to include the ParsedownExtra.php file (or if you are using Composer, just composer require erusev/parsedown-extra) and make an instance of the ParsedownExtra class.

—
Reply to this email directly or view it on GitHub #306 (comment).

[aidantwoods]

Closing since the extension fills this role

[sbrl]

Is it possible to add ids automagically with ParsedownExtra?

[cossssmin]

@sbrl What would the automagically-added ID look like? Consider this heading:

# I'm not (exactly) sure how to create/build my own ID

Yeah, it could manipulate the string into some sort of slug, but how could ParsedownExtra know what kind of 'slug' you want, or how long the text of the ID should be?

For example, maybe you want it to output:

<h1 id="im-not-exactly-sure-how-to-create-build-my-own-id">I'm not (exactly) sure how to create/build my own ID</h1>

OK. Then again, maybe someone would prefer underscores:

<h1 id="im_not_exactly_sure_how_to_create_build_my_own_id">I'm not (exactly) sure how to create/build my own ID</h1>

Surely, for long text, everyone would like short IDs, maybe something like:

<h1 id="create-build-own-id">I'm not (exactly) sure how to create/build my own ID</h1>

That's why this belongs to userland. Either create an extension that 'slugifies' the text as you need it, or just use ParsedownExtra as intended:

# I'm not (exactly) sure how to create/build my own ID {#custom-id}

[sharpicx]

are u sure if this {#id} in the ParsedownExtra.php? seems like the id isnt rendered anymore