Apple's help books are barely documented, so I wrote up how I build one out of the same Markdown that feeds my docs site.
The trap that cost me an evening: hiutil's CoreSpotlight index only works once Spotlight has imported your help bundle, and that never happens for a debug build out of DerivedData. Use the legacy LSM format instead.
pandoc and a ten-line Lua filter do the rest.
https://www.lilback.com/mac-help-book-from-markdown/
#macOS #MacDev #Swift #Xcode #iOSDev
