Skip to content

Feature Request: Keyboard-first text selection & improved annotations #18#22

Open
James-R-Chapman wants to merge 10 commits into
bugzmanov:mainfrom
James-R-Chapman:added_export
Open

Feature Request: Keyboard-first text selection & improved annotations #18#22
James-R-Chapman wants to merge 10 commits into
bugzmanov:mainfrom
James-R-Chapman:added_export

Conversation

@James-R-Chapman

Copy link
Copy Markdown
  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
Copy Markdown
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

bugzmanov commented Jan 9, 2026

Copy link
Copy Markdown
Owner

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
Copy Markdown
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

bugzmanov commented Jan 10, 2026

Copy link
Copy Markdown
Owner

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