I also plan on supporting an

Api

section which is instrospected from the type listing all its public API and deriving runnable examples from the Kdoc they are annotated with

Not 100% sure I follow the this. Why not just use dokka?

Dokka is great and we can use to generate the API docs. But when we want info from the types in Jekyll in markdown we can't intermix dokka in our docs afaik

I'm still don't quite follow what you want to do 😅 so couldn't say ;p

I want o generate a block embedded in our docs including the list of public methods and if they contain examples in their kdoc include them for the playgrounds in our site to run them

Dokka does a little more. You can also inline examples that are written as tests and IntelliJ also has tooling to show it in tooling.

that'd be great, thanks!