Originally published at: AppBITS: adoc Studio Eases AsciiDoc Publishing - TidBITS
Adam Engst looks at adoc Studio, a new app for creating and previewing AsciiDoc files. AsciiDoc is a markup language for long technical documents, and adoc Studio simplifies the process with a native Mac interface and numerous helpful features.
This looks very promising, once I get my head wrapped around how everything works.
I’ve been looking for a tool in which to write my documentation which allows me to work with complex formatting. I’ve tried Markdown but have been tripped up with integrating graphics in such a way that they work well with the text.
I’ve used a lot of different tools over the years (PageMaker, FrameMaker, InDesign, WriteNow, Word, Pages and many more). As you see from the list, many of those no longer exist (for a current macOS version and hardware) and anything I wrote using some of those older tools is pretty much inaccessible now, at least without a fair amount of effort.
While I’m sure that image formats will be my eventual stumbling block, I won’t have to worry about reading the text which I wrote, which might be much more valuable than the pictures.
I’m diving in with the demo and looking forward to recreating some recent documentation.
3 Likes
Oh great, need to check this out. I just finished a long documentation project with mkdocs-material, which is quite nice, but it still gets a bit messy if you need special formatting.