adoc Studio - Writing App5.1 - App Store

ADOC STUDIO - DOCUMENTATION DONE RIGHT

AsciiDoc at its finest. The text-based editorial system for Mac, iPad, and iPhone.
COMMUNITY EDITION

. Use the core features of adoc Studio for free.
. Upgrade to Pro when you need more.
INTUITIVE STRUCTURE

. Manage text, media, and other components of your technical documentation in an adoc Studio project.
. Use document includes to organize extensive content into chapters.
. Navigate even the most complex documentation with the project sidebar.
. Track down issues with the Problem Navigator.
WRITE

. Write your text in the editor on the left.
. With the side-by-side preview, see instantly how it will look in HTML or PDF.
. Easily insert images, tables, cross-references, formulas, admonitions, and attributes.
. With the built-in adoc Coach, all the powerful features of AsciiDoc are just one ESC keystroke away.
SHARE

. Use attributes and conditional content to automatically tailor your documents for different audiences.
. Like a modular system, assemble all relevant information. Text variants have never been easier.
. Export HTML exactly as shown in the preview, or customize the format, style, and appearance individually.
WORK ON THE GO

. Need to work on the go? No problem. adoc Studio delivers full functionality on Mac, iPad, and iPhone.
. Even on small screens, the interface stays clear and comfortable.
. Create, revise, and export your documents wherever you are.
. Cloud sync keeps everyone up to date at all times.
. Not a fan of the cloud? Since AsciiDoc is plain text, you can manage your project with Git.
TRIAL AND PRO SUBSCRIPTION

. Try adoc Studio Pro free for 14 days - no strings attached.
. Then start a monthly or annual subscription.
. Every subscription automatically covers Mac, iPad, and iPhone.
PRO EDITION FEATURES

. Automate recurring exports easily with products.
. Export your entire project as a complete website - with sidebar navigation, search, and language switcher.
. Create projects with multiple languages.
. Translate entire sections or documents with AI-powered translation.
. Select text and let the AI improve, shorten, rephrase, or proofread it.
. Generate fully accessible PDFs compliant with the PDF/UA standard for screen readers and assistive technologies.
. Count characters, words, and paragraphs - with or without spaces or markup.
WHO IS IT FOR?

. Technical writers and documentarians
. Developers and programmers
. Bloggers and content creators
. Authors and writers
. Markdown users looking for more features

Unleash your creative potential and experience the future of structured writing with adoc Studio!

Privacy Policy: https://www.adoc-studio.app/legal/app-privacy
Terms of Use: https://www.adoc-studio.app/legal/terms

Version History - Improved general stability. 5.1 Sep 15 WHAT'S NEW

This update brings powerful new export options, smarter multilingual workflows, and a refreshed look for macOS & iOS 26.
PDF EXPORT

• Protect your PDF exports with passwords using the new ads-pdf-owner-password and ads-pdf-user-password attributes.
• Fine-tune what readers can do with your documents — printing, changes, copying, commenting, and form-field entry — through the new ads-pdf-allow-printing, ads-pdf-allow-changes, ads-pdf-allow-copying, ads-pdf-allow-commenting, and ads-pdf-allow-form-field-entry attributes.
• Apply Quartz filters to your PDF exports with the new ads-pdf-filter attribute (macOS only).
TRANSLATE ENTIRE PROJECTS WITH AI

• A new automated workflow translates multiple documents into multiple languages at once. Find it in the new Manage Languages panel, available from the File menu and the context menu.
LIGHT AND DARK IMAGES

• Provide separate light and dark variants of an image. HTML exports include both and switch automatically to match the reader's environment.
MORE FLEXIBLE INCLUDES

• The include directive can now pull in just the parts of a file you need. Use the lines attribute to include specific lines or a range, or the tags attribute (or tag for a single region) to include content between your own tag markers.
FINER CONTROL OVER SECTIONS

• Hide a section's title with the new notitle option, using either the named syntax (opts=notitle) or the shorthand (%notitle).
• Exclude a section and all of its descendants from the table of contents by setting its toclevels block attribute below its own level (for example, [toclevels=0]).
SMARTER COACH

• Filter attributes not only by name but also by their current value.
MISCELLANEOUS

• Errors and warnings from exports are now collected and displayed together in the error navigator.
• The main toolbar has been reorganized and now embraces the new Liquid Glass design of macOS 26 and iPad OS 26. 5.0 Sep 1 Improved general stability. 4.1 Apr 28 STATIC SITE GENERATOR (PRO)

Export your entire project as a complete website. Includes automatic sidebar navigation, search, and an optional language switcher.
TRANSLATION MANAGEMENT (PRO)

Create projects with multiple languages. Ideal for international documentation – manage any number of language versions with automatic grouping through language tags.
AI-POWERED TRANSLATION (PRO)

Translate entire sections or documents with AI. AsciiDoc syntax is always preserved – only the content is translated, formatting and structure remain intact.
AI WRITING TOOLS (PRO)

Select text and let the AI improve, shorten, rephrase, or proofread it. Ideal for technical documentation that needs to be clear and precise. Use ChatGPT, Claude, or Gemini. Enter your own API key and access your preferred LLM directly in adoc Studio. AsciiDoc syntax is always preserved.
ACCESSIBLE PDFs (PRO)

Generate PDFs compliant with the PDF/UA standard for screen readers and assistive technologies. Structure tags, reading order, and text extraction are automatically correct.
IMPROVED PDF PREVIEW

Work faster with the new PDF preview. Finished pages appear instantly – no more waiting for the entire document.
MOVE LINES

Use the new menu command to move individual lines up or down in the editor – also available via keyboard shortcuts.
TEXT STATISTICS (PRO)

Count characters, words, and paragraphs – with or without spaces or markup.
MENU BAR ON iPAD

With the new iPadOS 26, all features from the macOS version are now available via the main menu bar. 4.0.0 Apr 14 Improved general stability. 3.2.1 Jan 13 Fixed Issues:
- Improved general stability.
- The preview context menu action "Show Source" did not always work.
- When switching between apps, the editor scroll position or the zoom level could change.
- On the iPad, the preview search field wrongly offered a replace option.
- On the iPad, deleting documents on iCloud Drive did not always work.
- Project spelling dictionaries were not always auto-saved. 3.2 08/20/2025 New Features:
- You can now add comment blocks in the document header using four slashes (////) as delimiters.
- The user manual now contains a dedicated section for creating CSS product styles.

Fixed Issues:
- Improved general stability.
- Resource links in the HTML export could be invalid when repeatedly exporting.
- The adoc Coach could insert wrong section IDs for xrefs. 3.1 07/02/2025 With version 3 of adoc Studio you get a wealth of new functions and improvements that make your work with AsciiDoc even easier and more efficient.
BIBLIOGRAPHY

The bibliography is a special section that should not be missing in any scientific project. The list of references is its own area that includes a variety of books, papers, and articles. As a reference, you use the classic syntax for references in the text.
SF SYMBOLS FOR ICON MACROS

Since version 2, adoc Studio has been able to use the icon macro to place small symbols from the Font Awesome library in the text. Starting now, not only macOS and iOS software developers can enjoy SF Symbols. This is the collection of all symbols used in the various Apple operating systems. In adoc Studio 3, you have access to more than 6,000 images to describe your app interfaces.

Activate the Apple symbols by setting the following attributes:

:icons: font
:icon-set: apple
CONTROL RESOLUTION / REDUCE FILE SIZES

An important topic for exporting documents is images. The challenge is often their size. The product team usually provides images in maximum resolution. And that's a good thing. But a reader of documentation, for example on the iPhone, does not need images of hundreds of megabytes.

In adoc Studio version 3, there are new attributes to adjust the resolution of your images in the output. This way, you can dynamically reduce the file size of your documents with the following attributes:

ads-max-image-resolution → Sets the maximum output resolution of images (in dpi, dpcm, or dppx) if height or width are defined in the source code.

ads-max-image-width → Limits the image width in the HTML output if no fixed height or width is specified.

ads-rasterizing-resolution → PDF, SVG images, and STEM formulas are converted to PNG and set to a specified resolution (in dpi, dpcm, dppx).

ads-static-stem → Normally, STEM formulas are exported with JavaScript. With this option, they are included in the document as SVG (no more JavaScript required).
PROJECT DICTIONARIES FOR YOUR TEAM

Until now, adoc Studio used the system dictionary on your local machine. Any corrections went into it and were not available for other team members. For professional authors working on many different projects, this was not ideal. That's why adoc Studio 3 now has project-specific dictionaries.

When spell check is enabled (Edit → Spelling & Grammar → check “Check Spelling & Grammar”), you can add unknown words directly to a new dictionary. The new dictionary (.adict file) appears in the sidebar. Of course, it can be versioned, transferred to other projects, and used collaboratively by the team.
AUTOMATION WITH ADOC STUDIO

Documentation products are often automatically created – especially when they are ongoing projects. Starting with this version, you can integrate adoc Studio into your processes. You can install the adocstudio command line tool via the adoc Studio menu and then use it in all shell scripts. It offers the following sub-commands:

Document export:

adocstudio export documents --project Projektname.adocproject --document Dokumentname.adoc (Directory)

Product export:

adocstudio export products --project Projektname.adocproject --product Produktname (Directory)

Simply enter adocstudio help export products or adocstudio help export documents in the terminal to view all available commands.
NEW DRAG & DROP FUNCTIONS

1. Drag text from the source code editor

Now you can work with text snippets. You can drag text out of the editor. For example, drag it to your desktop to automatically create a new text snippet. Of course, a text snippet can also be dragged back into the editor.

2. Drag & drop into the source code

If you drag a file from the project navigator into the editor, an include statement is inserted.

If you hold down the Option key while dragging, its content will always be inserted. 3 04/23/2025 Fixed Issues:
- Improved general stability.
- Scroll position syncing did not always work in PDF preview.
- Scholary notes could be shown multiple times in the preview. 2.2 03/05/2025 Fixed Issues:
- Sometimes, the last text line in the source editor was not fully visible.
- When typing at the end of a source document, the editor scroll position could jump.
- Typing after a collapsed section could make the preview scroll position jump.
- When editing a document, the section title indentation could become inconsistent.
- Under some circumstances, the spell checking could highlight bogus ranges.
- The range highlights for syntax errors could hide spell correction highlights or text range selections.
- Improved speed of image previews.
- When opening the sidebar sections tab for the first time, the section structure was not expanded completely.
- When changing the window or sidebar size, the hidden preview pane could appear unintentionally.
- Spell checking errors sometimes appeared delayed.
- Images loaded from http or https urls could be previewed with a wrong aspect ratio.
- The ranges of a global text search results could become invalid after editing. 2.1 02/25/2025 WHAT'S NEW:
- AsciiDoc callouts to explain code blocks
- AsciiDoc anchors can now also be assigned within a line.
- AsciiDoc subtitles are now supported in HTML and PDF.
- AsciiDoc Bibliography adds a new way to reference sources.
- Syntax Completion (adoc Coach) for Icon Macros
- New product styles: Manual and Light
- The preview performance has been improved.

FIXED ISSUES:
- The general stability has been improved
- Under rare circumstances, the scroll position of the preview or the text editor could jitter.
- Image names are now excluded from the spell check.
- The triangular buttons for collapsing sections in the text editor were not always visible.
- The highlighting of search results was not removed under certain circumstances. 2 01/29/2025 Newly supported AsciiDoc Features:
- Positional attributes for inline images
- List continuations
- Block anchors

Fixed Issues:
- Fixed problems with comments in indented list item paragraphs.
- The menu item for italic text was missing a keyboard shortcut.
- Improved performance of cursor navigation under iOS.
- Articles without sections incorrectly had a preamble.
- Improved the synchronization of the vertical preview position in definition lists.
- Renaming duplicated styles caused a crash.
- The preview stopped rendering when using a document title ID. 1.0.1 08/06/2024 1.0 06/12/2024