I want to make some updates to a [free] ebook I wrote several years ago when Rice University was still running their Connexions service open to the world<p>I keep the most recent edition of that ebook as a pdf on my blog<p>What is the current "great ebook creation" toolset that all the Cool Kids™ are running? Is it to refactor it into something like Obsidian notes, connecting them, and exporting to pdf? Is it a 'classic' word processor like Apple Pages or Microsoft Word or Google Docs?<p>Beyond merely updating/expanding what I wrote previously, I also have a few other ebooks I want to compile - and would <i>like</i> to not learn more than one tool to do this.
This violates the "One Tool" constraint that OP requested, but the Standard Ebooks tool chain is available on Github for anyone interested: <a href="https://github.com/standardebooks/tools">https://github.com/standardebooks/tools</a>
I make some long notes for students that I am sometimes teaching.<p>I use Jupyter Notebook, and use export to PDF feature. It renders the code, the text, and LaTeX equations perfectly.<p>I have also written stuff in Markdown and converted them to EPUB and PDF via pandoc. But there were no equations there. I used Obsidian as the editor.<p>Don't really know what will fit your need. If it were up to me, I would have used LaTeX- end to end. There are just a lot of tools and packages, and online help available. I wrote my Master's Thesis- fully in LaTeX.<p>I have done some technical review for Packt Publishing, and they use MS Word for everything.
For ebooks that I publish to sell, I use Vellum (Mac only). But if it was more of a PDF only kind of thing, without needing to be optimized for traditional book formatting or ereaders, I'm guessing exporting to PDF through something like Word would be plenty good enough.
I write in Markdown using MindForger. Each chapter gets its own Markdown file. Plus additional Markdown files for frontmatter and backmatter.<p>Quarto converts the entire kit and kaboodle into HTML (for previewing), ePub, PDF and if you want it, AsciiDoc and DOCX.
I'm writing markdown files and using pandoc to build pdf.<p>I don't like writing latex directly, because I also want to make html based ebooks, because html ebooks can reflow according to different screen sizes.
For "Stratospheric - From Zero to Production with Spring Boot and AWS" (<a href="https://stratospheric.dev/" rel="nofollow">https://stratospheric.dev/</a>) we used IntelliJ IDEA.<p>For a technical ebook with lots of code samples using our trusted IDE just was the natural choice.
I recommend Jutoh. It's a commercial (but not expensive) cross-platform system written by the WxWidgets creator Dr. Julian Smart. It's on Jutoh.com.<p>It's very good with images, tables and code.
"Best" is probably whatever you're familiar with. If your pre-pdf content is in Word, I'd just run with it -- most 'classic' word processors can handle the export to ebook stuff just fine. I've done exports from Apple Pages without issue.<p>That said -- if you're looking for a layout that reflows based on the screen size (read: more suited for mobile devices), you might want to look at exporting to .epub rather than .pdf.
I had a good experience with Neovim and AsciiDoc [0]<p>You can get an epub and PDF out of it<p>[0] <a href="https://www.yieldcode.blog/post/asciidoc-for-book-writing/" rel="nofollow">https://www.yieldcode.blog/post/asciidoc-for-book-writing/</a>
Org mode exports XHTML, then I use a couple hundred lines of python with eBookLib and Beautiful Soup to smash out an epub.<p>Org mode is happy to do HTML, and LaTeX (for pdf generation) export as well.<p>I've seen nice things out of asciidoc, and it has an EPUB3 exporter. There's always pandoc if you want something super versatile.
Many things can generate an epub. You need one that passes epubcheck to go on Smashwords/Draft2Digital which gets you into Apple Books and all the even more minor bookstores. (Kindle doesn't care.)<p>I understand that Apple Pages outputs standard-compliant epub that can go straight onto Apple Books/SW/D2D.<p>Calibre <i>does not</i>. The Calibre authors think that epubcheck is trash and if you follow it, your books won't quite be right on the widest variety of epub readers, which is what they aim for. Beware.<p>When I tried Pandoc it didn't output a compliant epub, I'm told it does now.<p>Don't just run and hope - check the output against a variety of readers. You <i>will</i> hit issues.<p>(e.g. one I only found out about because someone just happened to use a Kobo reader.)<p>You may have to edit XHTML files in a .zip that has to be ordered in a particular way. (I hate epub so much.) Having done this, I don't recommend it at all. Here's my guide for people who've made poor life choices, e.g. me: <a href="https://davidgerard.co.uk/blockchain/2020/11/05/calibre-epub-and-epubcheck-the-curse-of-editing-xhtml/" rel="nofollow">https://davidgerard.co.uk/blockchain/2020/11/05/calibre-epub...</a><p>tl;dr if you have a Mac I'd just see what Pages can do for you. If not, you're gonna have fun!!
I've used Asciidoctor as publishing tool chain. It compiles to epub, pdf. Very easy to configure CI using GH actions. Plugins are also available for vscode and intellij.