Obsidian doesn't open .adoc files on its own. AsciiDoc isn't in the list of accepted file formats, and a moderator wrote in July 2025 that core support isn't on the roadmap. As of October 2026 you either convert the files to Markdown or install a community plugin that opens them.
The request Native support for AsciiDoc in Obsidian Core dates from 28 May 2020. As of October 2026 it has 340 likes and 92 posts, and the latest reply is from August 2026. The first poster had a lot of documentation in adoc and couldn't open it from the folder view.
In July 2025 an Obsidian team member tidied the thread and posted a notice. Support for AsciiDoc in core is not on the roadmap. The same post links three community plugins, and the plugin list has more today.
A 2020 reply in the thread gives a conversion in two steps. Asciidoctor writes DocBook, and Pandoc turns the DocBook into GitHub-flavored Markdown. After that, Obsidian treats the file like any other note.
Asciidoctor editor is a community plugin by dzruyk, one of the three in the moderator notice. Its README says it supports a view mode and an edit mode. You switch between them with the standard Toggle reading view hotkey.
AsciiDoc Live is a community plugin that renders .adoc, .asciidoc and .asc files with Asciidoctor.js. Its README describes a preview that updates while you type, a source mode with a toolbar, and image paste. Cross references open the target file and scroll to the anchor.
AsciiDoc Files opens .adoc and .asciidoc files in their own tab. You get a source editor with highlighting, a rendered preview, or both side by side. The preview runs Asciidoctor.js in safe mode, then the sanitizer of the app. Cross references open the target file.
The editor, the preview, cross reference links and code colors are free. Include directives, the outline and links panel, and HTML export need Pro.
MIT · no telemetry · core features free
Turn off any other AsciiDoc plugin first. Only one plugin can open a file type.
Install AsciiDoc Files from Community plugins and enable it.
Click an .adoc or .asciidoc file in the file explorer. It opens in the preview.
Use the buttons in the tab header to switch between preview, source, and source with preview.
To start a new document, run the command Create a new .adoc file.
To show included files in place, sponsor on GitHub and sign in from the plugin settings. Includes need Pro.
Nothing points that way. A moderator notice from July 2025 states that AsciiDoc support in core isn't on the roadmap. The request stays open and still gets replies, the latest in August 2026.
A community plugin named AsciiDoc Blocks renders AsciiDoc from a code block inside a note. Its README says it focuses on tables. Other AsciiDoc features might work, it says, but come with no warranty or support.
No. Only one plugin can open a file type. AsciiDoc Files shows a notice when another plugin already has .adoc. The READMEs of Asciidoctor editor and AsciiDoc Live give the same advice.
Open .adoc files in Obsidian with a highlighted source editor, a rendered preview, or both side by side.
