search

sillsdev / docu-notion

Download Notion pages as markdown and image files, preserving hierarchy and enabling workflow properties. Works with Docusaurus.
MIT License
159 stars 30 forks source link

[Question] How does it compares to notion-to-markdown #88

Closed kmlbgn closed 11 months ago

kmlbgn commented 11 months ago

Hey, may you allow me a potentially silly question: After spending a little time on both codebases, I'm wondering what is the main difference between docu-notion and notion-to-markdown, as docu-notion extends from the latter. They both achieve conversion to md and allow custom transformers to produce desired outputs format. I first thought that docu-notion was meant to produce outputs tailored for Docusaurus, but the readme suggests its actually generic.

Thanks a lot

hatton commented 11 months ago

Right, we only use docu-notion for Docusaurus sites, and are only interested in making sure it works well with Docusaurus. But the set of markdown files it produces would be useful for non-Docusaurus sites as well. Hope that helps.

kmlbgn commented 11 months ago

Sure did ! I'd like to take the opportunity to ask you why was this case not handled purposefully : https://github.com/sillsdev/docu-notion/blob/a73e04035bab0ad65e54e8565b21b6e5a23e7317/src/pull.ts#L200-L202

In fact, Docusaurus do allow Category to have Doc Link to display content when clicking on the dropdown item. It's pretty handy. Is it because docu-notion rely on autogenerated sidebar only?

hatton commented 11 months ago

Perhaps it was added later?

kmlbgn commented 11 months ago

Oh right, i'll try it out, thanks for answering @hatton

kmlbgn commented 11 months ago

@hatton my forked version now handles Category with index.md derived from its content. Can't PR cause had to change a few other things but the update is quite simple. If you are interested I can make a dedicated branch and cherry pick for PR.