adoc Studio Version 2 is Here!

Whether you're working with technical documentation, books, or software manuals, this update brings more flexibility, better syntax support, and smoother performance. All features and bug fixes are also mentioned in our release notes.

Let’s take a look at the highlights in version 2!

New AsciiDoc Elements

1. AsciiDoc Callouts

AsciiDoc callouts now allow you to annotate your code blocks more effectively. Callouts are small numbered bubbles (<1>, <2>, etc.) placed in the code, followed by an explanation below.

[source,python]

----
def add(a, b): # <1>
    return a + b  # <2>
----

<1> This function takes two arguments
<2> It returns their sum

2. Anchors on Inline Elements

Previously, anchors could only be assigned to entire sections. Now, you can place them within a line, making cross-referencing smoother.

<<#id, This reference links to the new ID>>

[[id]]This is the referenced text

3. Subtitles for HTML & PDF Outputs

AsciiDoc now supports subtitles in both HTML and PDF exports, giving documents a more professional look.

4. Bibliographies for Better Referencing

Need to cite sources? You can now add a bibliography with AsciiDoc’s new referencing system.

[bibliography]

- [[[ref-1]]] John Doe. Technical Writing Essentials. 2024.

5. Icon Macros incl. Syntax Completion

Choose between different sets of icons and set them directly in your text.

• Font Awesome :icons: font

• SF Symbols :icons: apple

The adoc Coach also provides auto-completion for icon macros. Just type icon: and get instant suggestions for available icons!

New Product Styles: Manual & Light

We’ve added two fresh styles—Manual and Light—so you can customize how your documents look. Whether you prefer a clean, minimalist style or a detailed technical manual format, these styles help you get the perfect presentation.