Skip to content

Conversation

@James-R-Chapman
Copy link

  1. No markdown export
    No way to export annotations to markdown.

Want: Space+e to export all annotations as markdown.

Implemented, also added .md, .org, and .txt file integrations.
Upon first run will also add the necessary options to your ~/.bookokrat_settings.yaml for export location (defaults to your epub directory initially) a frontmatter_template for your markdown, org, or text files and also backed up a moment and added commentary and the yaml to create the "annotation_highlight_color:" field.

@bugzmanov
Copy link
Owner

@James-R-Chapman
hey. i've looked through this solution. it looks good visually, but it is too big (i guess because it has a lot of flexibility)

the annotation internals right now have a lot of issues (it was vibe-slapped atop of bookokrat when i need it to write a critique article)
i think that I will have to do some redesign of the internals before exporting should be implemented.

Sorry.

@bugzmanov
Copy link
Owner

bugzmanov commented Jan 9, 2026

ok. this is unblocked now.
Can i ask for some simplifications?
lets support just one format: md. lets support just one mode - into one file. lest support only one format: context + comments.

ideally export should be feature available only in annotation overview window.
the user should be able to specify the name of the file to export to ( but i like the idea that is in this PR - make initial suggestion based on book file name)

Pushed to where highlights work between multiple paragraphs, portions of
paragraphs, bullet lists, and bullet list & paragraphs.
@James-R-Chapman
Copy link
Author

I just now seen these comments, my initial release with the export mode was just thrown out there, because I'm a very indecisive person and I sometimes use markdown and sometimes use org for my notes (thanks adhd) but the push that currently did handled alot of items that were with the annotations. and it also solved issue #18 pain point 3, where it will go back through the actual book_*.yaml file when you add another highlight or annotation it will extract the "context" along with the "content". I can adjust the export to where it only shows in the Space+a annotation menu. (maybe I should add a extraction_filetype: variable to where it kills off that menu after the first use of export.

@bugzmanov
Copy link
Owner

bugzmanov commented Jan 10, 2026

I just now seen these comments, my initial release with the export mode was just thrown out there, because I'm a very indecisive person and I sometimes use markdown and sometimes use org for my notes (thanks adhd)

@James-R-Chapman
My reasoning that users who need different formats are probably comfortable with tools like pandoc or something similar that convert md to anything one might want.

And thus single md file seems like the most common use case. Everything else can be achieved outside bookokrat.
My thinking is still from pre-AI era: i like tools to be focused and concise

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants