Live data from Hacker News

Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

sosumi.ai

41–50 of 74 posts

Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

#41
Great promise; sometimes need to reference docs to build context.

I looked at the examples you posted and did a quick glance. For example

'''init?(exactly: Float80)'''

the tool converted it to

'''- [initexactly-63925](/documentation/Swift/Double/init(exactly:)-63925)'''

To achieve its goal I would be worried that it dropped the verbatim function signature. Claude still figured it out, but for more obscure stuff that could be an issue.

Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

#45

Great promise; sometimes need to reference docs to build context. I looked at the examples you posted and did a quick glance. For example '''init?(exactly: Float80)''' the tool converted it to '''- [initexactly-63925](/documentation/Swift/Double/init(exactly:)-63925)''' To achieve its goal I would be worried that it dropped the verbatim function signature. Claude still figured it out, but for more obscure stuff that…

Thanks for pointing that out. That’s most likely a mistake in how I’m translating into Markdown. I’ll look into this.

Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

#46

How to reliably HTML to MD for any page on the internet? I remember struggling with this in the past How hard would it be to build an MCP that's basically a proxy for web search except it always tries to build the markdown version of the web pages instead of passing HTML? Basically Sosumi.ai but instead of working on only for Apple docs it works for any web page (including every doc on the internet)

https://pure.md is exactly what you're looking for.

But stripping complex formats like html & pdf down to simple markdown is a hard problem. It's nearly impossible to infer what the rendered page looks like by looking at the raw html / pdf code. https://github.com/mozilla/readability helps but it often breaks down over unconventional div structures. I heard the state of the art solution is using multimodal LLM OCR to really look at the rendered page and rewrite the thing in markdown.

Which makes me wonder: how did OpenAI make their model read pdf, docx and images at all?

Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

#47
Hm, I would have extracted the markdown from the Swift source code. That’s what Apple uses to generate their pages, using https://www.swift.org/documentation/docc/.

For example, AFAIK, https://github.com/swiftlang/swift/blob/main/stdlib/public/c... is used to generate https://developer.apple.com/documentation/swift/array.

Post reply on HN