AT3, Scrivener, and Obsidian

A feature request to sync AT with Obsidian created an interesting discussion: Aeon working and syncing with Obsidian

I just discovered that Scrivener can write its document files in markdown to a sync folder that’s shared with Obsidian. Moreover, AT3’s metadata, which can be synced to Scrivener, can be written by Scrivener to a YAML frontmatter block in the markdown file.

This seems to open the possibility of achieving a syncing relationship between AT3, Scrivener, and Obsidian. Moreover, since Scrivener can automatically assign a numerical value representing the order of scenes, and place that value into the YAML, we could then use Obsidian’s Dataview plugin to always have the correct order of scenes in the view.

This could be promising. Before I head down this rabbit hole, I wonder if anyone here has already done something like this. If so, I’d love your perspective and advice.

5 Likes

Success!

My goal was to be able to write in either Scrivener or Obsidian and have them sync.

So I set up a Scrivener sync file that copies the scenes and chapters to a shared folder in the Obsidian vault. Scrivener can be set to share the files as .md files, which is just what we need.

Also, if I add, delete, or move a scene AT3 or Scrivener (which, again, already sync), I wanted that reflected in Obsidian. Scrivener has an option to automatically prepend to each .md file it writes to the shared Obsidian folder a number representing its order in the Scrivener binder. Obsidian dutifully reordered the files (scenes) in the Obsidian file explorer according to the prepended number. (How cool is that? And let’s not forget that Scrivener also syncs to AT3 in that regard.)

The result? I can now write in either Obsidian or Scrivener and the two programs will sync. I can move scenes around in Scrivener or AT3, and Obsidian will reflect that new order/structure.

Not only that, but I set up syncing to be automatic on closing Scrivener, plus there is a hotkey to manually trigger syncing (or, in my case, a Stream Deck key) if I want to.

One issue is that if I create wiki-type links in Obsidian when drafting, they will show as nonfunctional [[links]] in Scrivener. I don’t mind; I can probably find a way to remove those via a script if they bother me. They don’t, as most of my wiki-type links in Scrivener are in the story bible, and I don’t have any reason to sync those .md files to Scrivener. So there will be relatively few such [[links]] in my narrative as I write the manuscript.

I no doubt will do some tweaking but I think this is going to let me use all three programs for what each is best at.

4 Likes

Hey! I’m looking to setup sync between AT and Obsidian as well. If it takes having Scrivener inbetween, so be it.
Would you be so kind as to share more details on your workflow? How is the syncing to the shared folder being done? Did you write a bat file?
I’d also be interested in how to setup Scrivener to handle markdown in a way where it doesn’t conflict in Obsidian.

Thanks!

Happy to.

No batch file is needed. I use Scrivener’s built-in sync folder function to create a shared folder inside the Obsidian vault. Scrivener can then write, monitor, and update/sync the shared .md files any time you change them from either Obsidian or Scrivener (or, through syncing between AT3 and Scrivener, in AT3).

My assumptions:

  1. You want to sync AT3’s Narrative or Outline views, rather than the Timeline or Spreadsheet views.

  2. You want to do your writing primarily in Obsidian, yet be able to make changes and move things around in AT3 and have such changes reflected in Obsidian, even the order of things.

  3. You have an active AT3 project.

  4. You do not have an active Scrivener project.

  5. I use Scrivener 3 for Windows; if you don’t, I assume this will all work with the Mac version, too, but you’ll need to verify that.

The first step is to create a blank Scrivener project and, following the AT3 documentation, sync AT3 to that Scrivener project. Your Scrivener project will automatically be populated with all the AT3 narrative events plus any metadata you choose to sync.

Next, consult the Scrivener documentation to set up a shared folder. Be sure to create it inside the Obsidian vault. Call it something like “Scrivener sync.”

Lastly, inside Scrivener, initiate the sync process. Scrivener will write its documents to that shared file, but you will configure syncing so that Scrivener writes them as .md files rather than its native .rtf files. Initially, since your Scrivener documents are blank (because you’re working with a new Scrivener project), it will create .md files without content. You can then copy/paste whatever content you’ve already written into the relevant .md file. You can paste in any YAML block text as well. From that point forward, you can write to these .md files, and Scrivener will sync them back to Scrivener (syncing can be automated to trigger when closing Scrivener and can be manually done, too). Then, you can sync Scrivener to AT3 using AT3’s syncing.

If you want, you can configure the Scrivener sync function to prepend to the .md file name a number representing its position of the Scrivener (and, through syncing between AT3 and Scrivener, AT3) narrative. It will then show the files in the narrative order in Obsidian’s file manager. Here’s what they look like in Obsidian (disregard those small numbers representing word count; those are added by a plugin called Novel Word Count):

Unfortunately, as you can see, Scrivener insists on appending a bracketed number, such as [2] in the highlighted .md file, to each .md file name. It uses this number to enable any changes made to the file to be synced back to Scrivener. That can create an issue with Obsidian’s wiki-like linking when linking to that file. I’ve discussed this issue, and how it doesn’t impact my workflow, in the Scrivener forum, here: Scrivener, Obsidian, and Aeon Timeline…Oh My! - Scrivener - Literature & Latte Forums. I also discuss using link aliases as a workaround if this is truly a problem in your workflow.

I hope this gets you started. Let me know if I can answer any questions.

1 Like

I noticed today that someone wrote a Python script that is supposed to export literally everything from an AT3 project into linked Obsidian notes. Though unfortunately when I tried using it, I got an error. Hopefully the author will respond with help in getting it to work.

https://forum.timeline.app/t/exporting-aeon-timeline-3-to-obsidian/2038/33

Sure, exporting into .md files that are usable in Obsidian can be useful.

I was going for something more ambitious–getting Obsidian, Scrivener, and AT3 to sync with each other, so that changing something in, say, Obsidian can sync with Scrivener which can sync with AT3. I’ve achieved it, but the limitations are holding me back from really using this setup. Honestly, if Aeon Timeline would just add a text editor for each scene or for combinations of scenes (like Scrivener), it would make my day.

Yeah that would be ideal, to have all three programs working in perfect unison.

When you use Scrivener, do you have a separate project per book (novel) or one single project for the entire series? I’ve thought about this a few weeks ago and decided to keep them separate. But that was before I decided to use Obsidian as my canon and repository of knowledge.

Now, the idea is to get Obsidian to have literally all the facts, but so much goes into the timeline that isn’t in the Obsidian notes, that I’m just hoping for a way to export AT3 stuff into Obsidian for the sake of its global lookup and organization power. Though I’m not really sure what to do about the fact that repeated exports would override Obsidian notes. Best, I think, is to have a “Timeline” folder in the vault and that never gets edited within Obsidian. Just exports from AT3.

Great question. I use one project in Scrivener, which syncs to one project in AT3, for all three novels. This lets me look at the entire story across all the novels, which is especially helpful in, say, the Subway map view.

FYI, I’m thinking of dropping my use of Obsidian and just using Scrivener notes for my story bible stuff. It’s not as robust as Obsidian, but it does have the advantage of being able to sync back to AT3. Plus I’d only have to manage two apps rather than three. We’ll see. :slight_smile:

Steve, you mention using scrivener notes as bible fodder. I do the same thing.

Would those be the notes attached to each scrivener document or a note in a non manuscript folder?

If it’s the former, how did you get them into AT? I would love to see a popup (i.e. like Plottr) in the AT outline that renders the Scivener note for a scene.

I still use and love Obsidian, but in the last year it has become obvious that I need to control where I do prose creation; in my case I end up leaving ideas & snippets all over the place and they do get lost in the shuffle between apps and a lost darling is depressive thing :slight_smile:

Obsidian is amazing, but in the end, we have to craft a novel. AT3 and Scrivener sync beautifully, and Obsidian doesn’t, which can impede the creative process.

I currently sync the manuscript in Scrivener to AT3, but I’m thinking about syncing the notes content as well. What gave me the idea was that I saw in the AT3 sync setup that I can sync Notes folders to AT3, not just the narrative/manuscript documents, which I currently sync. I’ve never tried syncing to Scrivener notes, but I figured there must be a reason for that option.

But now that I think about it, I’m unsure what advantage there would be to syncing the notes content to AT3 (surely there must be one; otherwise, why give us that option?). I need to read the documentation and experiment.

Been searching… with regard to scene notes in Scrivener, it was mentioned that they don’t do it because the text is in rtf format. That makes sense, as both sides would have to persist styling choices.

Agreed about the AT syncing with Scrivener, it has been flawless for me and I was delighted to see it is two way. That and how Scrivener is bulletproof with Dropbox. Might be prudent for me not to get carried away; I do have screen real estate to view them both at once.

Yes, the syncing of non manuscript folders is wonderful. I track folders containing chars, locations, arcs, activities, and themes. Being able to set the item properties to relate these to other entities and items is awesome.

AT has done its homework on this interface.

Cheers!

I guess it depends on complexity weighed against the need for syncing. For me, my world is insanely detailed, and I’ve struggled to keep my notes straight for a decade now. It’s such a relief to be able to have a central repository of knowledge, but there’s simply no way Scrivener could achieve this. Not with the epic tools like graph filtering.

And that’s just the core notes. So much more to come.

Scrivener’s use seems to be in the actual writing itself, but I’m unsure why the full canon needs to be in Scrivener at all. I can alt-tab between that and Obsidian just fine if I want to check on details. What’s your use case for integrating your world notes into Scrivener? I’m curious.

Great question, and one I’m struggling to answer. As I think about it, there might be important disadvantages to consider. Let me experiment just a bit and I’ll come back with my thoughts.