r/ObsidianMD • • Jan 31 '25 This Heartwarming

Obsidian Community resources

223 Upvotes

Welcome to r/ObsidianMD! This subreddit is a space to discuss, share, and learn about Obsidian. Before posting, check out the following resources to find answers, report issues, or connect with the community.

We also really do enjoy your memes, but they belong in the r/ObsidianMDMemes subreddit. :)

Please be sure to read our Code of Conduct to help make this space an awesome place to discuss all things Obsidian. Please, don't be a shill.

Official resources

In addition to Reddit, there are several official channels for getting help and engaging with the Obsidian community:

Need help with Obsidian? Check the official documentation:

To keep things organized, please report bugs and request features on the forum:

For Obsidian Importer and Obsidian Web Clipper, submit issues directly on their GitHub repositories:

Community resources

The Obsidian community maintains the Obsidian Hub, a large collection of guides, templates, and best practices. If you’d like to contribute, they’re always looking for volunteers to submit and review pull requests.

Library resources

Obsidian relies on several third-party libraries that enhance its functionality. Below are some key libraries and their documentation. Be sure to check the current version used by Obsidian in our help docs.

  • Lucide Icons – Provides the icon set used in Obsidian.
  • MathJax – Used for rendering mathematical equations.
  • Mermaid – Enables users to create diagrams and flowcharts.
  • Moment.js – Handles date and time formatting.

Plugin resources

Obsidian supports a wide range of community plugins, and some tools can help users work with them more effectively.


This post will continue to expand—stay tuned!


r/ObsidianMD • • Mar 31 '26 Bravo

If your first post is to promote your app, you will be banned.

1.5k Upvotes

Reminder: this subreddit has a rule: "Don't shill".

If your first and only post is to promote your project (vibe-coded or otherwise), you will be immediately banned. This is not a place to post projects that are tangentially related to Obsidian and that you have spammed to other subreddits.

This community is for Obsidian users discussing questions, tips, workflows. You're welcome to share what you’ve made for Obsidian such as plugins, themes, guides, videos, utilities, tools, and more. But please try to be a contributing member and not just here to promote your thing.

See our Community Code of Conduct for more details.


r/ObsidianMD • • 1h ago

plugins I made Customization Studio, an Obsidian plugin for styling supported plugin interfaces

Post image
9 Upvotes

Hi everyone, I'm the developer of Customization Studio. It's now available in Community Plugins, and I'd love some feedback.

It adds visual settings for supported interfaces in Kanban, Spaced Repetition, Bases, Tasks, Dataview, Calendar, and Day Planner. The aim is to adjust their appearance without changing your notes or the other plugins' settings.

You can start with one of five presets, create your own profiles, import/export them, and adjust things like colors and spacing. Optional custom CSS is available too.

A heads-up: this is an early release. Theme and plugin-version compatibility still needs real-world testing. The Tasks, Dataview, Calendar, and Day Planner integrations are off by default; enable them under Integrations in a custom profile.

It's free and open source. If you try it, I'd be interested in which integration you use, what doesn't look right, and which visual controls you'd want next. Please include your theme and plugin versions when reporting an issue.

https://obsidian.md/plugins?id=customization-studio


r/ObsidianMD • • 5h ago

help Tablet layout

Post image
6 Upvotes

I'm planning on buying a tablet, and I'm asking whether this is what the layout looks like in the tablet? Or is it just the same as the mobile interface?


r/ObsidianMD • • 21h ago

plugins UPDATE: I am building a "rendering" plugin for sheet music, maps, many charts, and more

Post image
85 Upvotes

Add rich visual components to notes, including interactive diagrams, inline comments, zoomable timelines, embedded maps, and music notation. Render ABC sheet music with playback, real-time note highlighting and MIDI export, and create interactive, responsive charts using Observable Plot or D3 from YAML or JavaScript. Also, this makes subscript and superscript available across obsidian.

Now it's published in the community! https://community.obsidian.md/plugins/insightpage-style


r/ObsidianMD • • 4h ago

help Are Obsidian Sync servers secure?

2 Upvotes

I really like how Obsidian is local, no need to worry about my data being sold, used to train an AI, or stolen.

But I'm considering using Obsidian Sync so I can have access to my notes on all my devices, but are their servers secure?

Or are they known to sell synced user data to third parties?

I know the solution to this concern is just setting up my own server, but I wanted to ask on here about Sync first because of how convenient Sync is.

Thanks!


r/ObsidianMD • • 2h ago

sync Onedrive but no sync. Is it viable?

Post image
0 Upvotes

Writing a book in Obsidian, i already have obsidian sync. But I feel like it would be good practice to also manually save my vault in Onedrive.

I won't put too much effort into this, i will do this manually like every 10 chapters i write.

Is this smart? Stupid? Not a big tech guy so help me out!


r/ObsidianMD • • 12h ago

help Plugin recs for someone with horrible memory problems?

6 Upvotes

Hi everyone! As the title says, Ive been having memory issues for the past 5 or so years. It might be stress, it might be ADHD, it might be something else entirely, who knows!

Point is, I really need to organize myself. To keep track of my symptoms (regarding this and other health issues), for work, and to write down ideas for my DnD campaigns.

I don't know where to start, honestly. I'd like something beginner friendly but powerful. I also read theres a plugin that lets you connect ideas or topics together? That sounds good, too!

Anything that's not hard to learn/start using would be appreciated, cheers!


r/ObsidianMD • • 5h ago

help Obsidian asking me to trust myself to open my own vault?

1 Upvotes

hello, i thought i had fixed the issue by myself but it seems like obsidian is probably ragebaiting me on this one

i created a new vault yesterday for worldbuilding, same location for the folder as the first one, same plugins, same themes, same settings—basically just a copy of the first created vault. i updated obsidian from 1.13.7 to 1.15.1 right before diving into any vault (mind you, it opened on the new vault because i closed the app on it last night), and now im getting this "Do you trust the author of this vault?". well, yes, because im the author of this vault

i deleted the new vault, manually installed every plugin (instead of copy-paste from one folder to another), and i relaunched the app a few times to test it. except now it's back, every time, and it's not asking me this when i open any other previous vault. does it have to do with any of my files (im still on windows 10 fyi) or the fact i updated my obsidian? thanks to anyone who'll help!


r/ObsidianMD • • 6h ago

help How do I register a CodeMirror LanguageSupport or LanguageDescription for code blocks with Obsidian?

1 Upvotes

I’ve kicked around in quite a few circles and gotten nowhere. registerEditorExtension is of course only for the giant EditorView in the sky. Attempting to insert my own new EditorView looks… out of place, and does weird things to the cursor and/or is a second-class pre citizen. Manually highlighting the DOM once it’s been rendered to get all the block, copy button, etc. in theory works, but I’m having a hard time with it and doesn’t really help the extensions, which even if I can bring them over, node.from will be all out of whack. Also I seemingly need to remap tags to Obsidian's CSS classes even though Obsidian surely knows how to handle t.comment.

I assume internally, Obsidian is using markdown({ codeLanguages: /*...*/ }) or something similar that takes in an array of LanguageDescriptions (or something similar) so it can just import all CodeMirror's prebuilt support. Unless Obsidian's using CM5 for that still, in which case this might be very bad for me :p But if there is some list, sometime and somewhere, u/kepano would it be possible to let us insert to that? Maybe a registerLanguageDescription (or some more direct way to touch it)? Does something like this already exist and I just missed it?

If anyone knows how to fix or workaround my problem, or a plugin that supplies in-code-block, CM6, custom syntax highlighting, maybe with extensions (which for those unenlightened looks more or less like anything fun besides the syntax highlighting itself, ie error messages (aka linting), autocomplete, other views, etc), that'd be great :D


r/ObsidianMD • • 12h ago

help Mac: External file open into new window?

2 Upvotes

Mac Obsidian will now open external files (from outside a Vault). I have it set as the default editor for .md files. (It's the best Markdown editor EVAR.)

Can Obsidian, or a plugin, be set so external files like that open in a new window?

I'd really appreciate the help.

(This is a repost of a really crappy original post. I apologize.)


r/ObsidianMD • • 1d ago

help why does it suddenly always load with the icons from the tool bar, vertically for about 5-10 seconds

Post image
14 Upvotes

r/ObsidianMD • • 23h ago

help Considering Publish for my website - looking for inspiration

8 Upvotes

Would love to see what others have put on the web via Publish - looking to understand what's possible.


r/ObsidianMD • • 3h ago

updates Grok Bot Can Now Find and Link Notes in Obsidian

0 Upvotes

I made a quick walkthrough of how to use Obsidian in Grok Bot. Here’s how to add the plugin, search your vault, and link a note in your daily journal 👇

https://youtu.be/mcwiGZYvE9w?si=So0nEYlnZmrnVBe9


r/ObsidianMD • • 20h ago

help Quiero migrar de Notion a Obsidian ¿Qué recomiendan usar?

4 Upvotes

Tengo que pasarme a Obsidian porque se me termina el premium y ya Notion se me hace lento.
Lo que me gustaría tener es un dashboard, un seguidor de hábitos, carpetas para mis apuntes de la universidad, calendario, tareas con un tablero Kanban, alguna herramienta para generar gráficos y una “biblioteca digital” donde apuntar mis notas de cada libro. También he visto que muchas personas crearon una barra lateral donde aparecen personas estilo Wikipedia.

Si soy sincero desconozco como crear todo esto, si saben que plugins, herramientas o formas de enlazar con IA para armar todo se los agradecería.


r/ObsidianMD • • 22h ago

help Obsidian Launcher to load directly into vaults?

4 Upvotes

Is there an existing launcher that can do that?

Now, I start Obsidian and then pick my vault. It could be more direct.


r/ObsidianMD • • 16h ago

help Fastest way to collect thousands of text snippets with backlinks?

1 Upvotes

Recently started to use Obsidian, I'm hoping to use it for thematic analysis of thousands of articles I've collected (saved as text files, not PDFs). Specifically, I wanted to have note files that correspond to individual themes, and within those note files there would be selections from the articles (a sentence or multiple paragraphs) along with a link back to the source block in the original article file.

Since I have so many articles to review, I'm hoping to find the lowest friction approach to this repetitive action (lowest number of clicks). For selected text:

  1. Save text selection to bottom of specified thematic note. Text selection would include link back to block in source article.
  2. Create block link reference in source article if it doesn't already exist.

Anyone have thoughts or experience with a project like this in Obsidian?


r/ObsidianMD • • 1d ago

plugins Folder Note Revamped: The classic Folder Note plugin is back, fixed, and in Community Plugins!

44 Upvotes

Hey r/ObsidianMD! If anyone here used to use xpgo’s original Folder Note plugin, you probably noticed it stopped loading in newer versions of Obsidian a while back since it hadn’t been touched since 2021.

I really missed having that simple click-a-folder-to-open-its-note & card workflow, so I’ve taken over maintaining/improving it as Folder Note Revamped. It recently made it into Obsidian’s Community plugins directory (currently on v1.0.10), so I figured I’d share it here in case others have been looking for a working successor.

Folder Note Revamped plugin page

So far I’ve mostly been focused on getting it healthy on modern Obsidian and chipping away at old bugs, especially those reported on the old repo:

- Fixed the ES5/ES6 load crash and removed/deprecated APIs so it runs on current desktop & mobile Obsidian (plus popout windows and current theme colors).

- Fixed a bunch of ccard / folder_brief_live edge cases (split panes, embeds, canvas, vault root, skipping .obsidian, and LaTeX/$ characters).

- Stopped it from hiding non-note files that share a folder's name (like .pdf or .base).

- Made Inside-mode rename sync use Obsidian’s file manager (so links update) and handle batch renames better.

Original screenshot of the Card style overview

If you still have the old plugin around, you’ll just want to disable/uninstall folder-note-plugin first so they don’t both handle folder clicks, and your existing folder notes will keep working as normal. (It also pairs nicely with Waypoint if you want real Graph View links inside your folder notes.)

I’m still actively working through old upstream issues and rough edges, so if you decide to give it a spin, I’d genuinely appreciate any bug reports, feedback, or edge cases you run into!

- Community Plugins: https://community.obsidian.md/plugins/folder-note-revamped

- GitHub: https://github.com/SamPlaysKeys/obsidian-folder-note-revamped-plugin


r/ObsidianMD • • 5h ago

help Free alternatives to Obsidian?

0 Upvotes

So full disclosure, I love Obsidian and don’t plan to stop using it. However, I’ve run into a bit of a mobility issue (which my research tells me is sort of common but I haven’t found a solution that has worked for me yet) where moving vaults onto an external hard drive in order to move them between computers does not work (found that out the hard way when I got to school to find an empty hard drive and no book to work on 😩)

I had been getting around this issue by using my Google Drive to transfer files between my computers. However, I recently found out about Google using the contents of folks Google Drive to train their AI models. So as you might imagine I’d like to keep my writing out of there (I understand that my data has very likely already been scraped but I’d like to prevent any further scraping as much as possible, ya know? Gotta do what I can)

When searching online, a lot of answers came in the form of other AI powered tools and obviously from my issue with Google Drive I’m not about that. I also use LibreOffice but I really like all the indexing and tagging I can do in obsidian (example I have a lot of characters in my book so I can tag what characters appear, or what locations, etc and it really helps me keep everything organized and the continuity consistent)

Does anyone know of another free writing software that’s comparable? Again, I don’t plan to stop using Obsidian—I just need a supplement.


r/ObsidianMD • • 1d ago

showcase Biology notes showcase :)

86 Upvotes

Not a lot of connections (yet)


r/ObsidianMD • • 1d ago

themes I resently switched to willemstad theme. But I'm sure which style setting i should use.

Post image
4 Upvotes

r/ObsidianMD • • 1d ago

plugins SupaBase Jump 1.2.0: Real-time editing across devices, version history, and safer sync

59 Upvotes

Hey everyone! A while back I posted about SupaBase Jump, a plugin that lets you sync your Obsidian vault using your own Supabase project.I got pretty busy with other stuff after that, but I finally had some time to come back to it and work on it again.A few things have changed since the last post:

  • Real-time editing with cursors. You can have the same note open on two devices and see each other typing, kind of like Google Docs.
  • Version history. You can right-click a note and restore an older version.
  • Deleted notes can now be restored from any device.
  • Better conflict handling. If you edit the same note on two devices before they sync, both versions are kept instead of one overwriting the other.
  • Better ios support. It now reconnects properly and catches up when you open the app again.

I also fixed quite a few bugs. One of them was a full sync stopping after 1,000 files, and another could cause offline edits to get lost.

If you're updating from an older version, you'll need to run the database setup again in the plugin settings for the new features to work.

Plugin page: https://community.obsidian.md/plugins/supabase-jump
GitHub: https://github.com/brianstm/obsidian-supabase-jump

It's still free and open source. If you try it out and run into any issues, let me know. Feedback and suggestions are welcome too.

Thanks to everyone who tried the plugin before and reported bugs or gave suggestions. It helped a lot.


r/ObsidianMD • • 1d ago

plugins Meetings Plus 0.8: this update is about what happens after the meeting, with tasks and open questions from your notes

28 Upvotes

Notes get typed fast during meetings, and tasks easily get lost in there.

Now you can start a line with T: for a task or Q: for a question. When you leave the note, or press "Harvest this note", the T: lines turn into normal checkboxes and the open questions are saved in the note's properties. The sidebar shows how many tasks are still open for each meeting.

The tasks are plain checkboxes in the note, so nothing gets copied anywhere. Tick them off in the note, or in the Tasks Plus plugin, which got an update at the same time and lists them across your vault.

New to Meetings Plus? It shows your calendar in the sidebar from an ICS link (Outlook, Google, iCloud, Proton and Fastmail all work) and creates a meeting note from your own template in one click. It only connects to your calendar link. No account and no tracking.

Harvest is off by default. Turn it on under Settings → Meetings Plus → Harvest.

Thanks to kscarmardo, jarno-lernou-skyline and OpenDeernet on GitHub for the fixes in the last two releases. Feedback and bug reports are welcome, here or on GitHub.

Install: Settings → Community plugins → search "Meetings Plus" and "Tasks Plus"


r/ObsidianMD • • 1d ago

showcase Aion Codex a new Obsidian Timeline plugin

Post image
44 Upvotes

I know, I know, there are a few Timeline plugins already for Obsidian. But none do what I wanted, exactly, so I created my own. Here's the Readme file and a screenshot. It's still very much in development, but if there's interest I release it sooner than later. C&C very much welcome.

Edit: As people have expressed interest, I've uploaded Aion to Github (I hope I'm doing it right, lol). Here it is: https://github.com/GMCWard72/aion-codex

Aion Codex

A customisable, Markdown-based vertical timeline for Obsidian.

Created by Guthrie Ward. Current version: 0.1.51.

Aion Codex organises a Chronicle into Ages, Years, Dates and Events. It was developed for worldbuilding and fictional histories, where a Year might be 804 BCE, Year of the Falling Star, or simply In the Beginning….

Years appear on the left, with Dates and their Events grouped in panels on the right. Age headings and optional descriptions divide the Chronicle into chapters. You can work through dialogs and drag/drop, edit the Markdown directly, or combine both approaches.

Features at a glance

  • Flexible labels: use numeric Years, named Years, custom Eras, approximate Dates, prophecies and undated Events.
  • Markdown storage: Chronicle content stays in the note, inside aion-timeline fenced blocks.
  • Linked Age blocks: each Age has its own block, while search, editing and movement work across the Chronicle within the same note.
  • Age overviews: optional Markdown descriptions introduce an Age before its Events.
  • Quick editing: separate Age and Event dialogs, icon controls, and an Add Event shortcut beside each existing Event.
  • Drag/drop: reposition Events, Dates, Years, Age headings or entire Ages, with insertion lines showing the destination.
  • Manual sorting: sort Years within an Age or Dates within a Year when you choose. Adding or editing never triggers automatic sorting.
  • Custom calendars: configure two Era names and an ordered list of Month names.
  • Starting Age: keep an unnumbered opening Age at the top and exclude it from sorting.
  • Chronicle-wide search: find content across linked Ages, including blocks not yet loaded on screen, and clear the search with one click.
  • Theme-aware appearance: configurable colours, text sizes, spacing and panel shading that adapt to Light and Dark modes.
  • Editable template: Insert example Chronicle reads a bundled Template.md that you can customise.
  • Large-Chronicle rendering: linked blocks and deferred Markdown formatting reduce rendering work as a Chronicle grows.

Install

Aion Codex is currently installed manually; these instructions do not require an Obsidian Community Plugins listing.

  1. Create .obsidian/plugins/aion-codex/ inside your vault.
  2. Copy manifest.json, main.js, styles.css and Template.md from the plugin folder into it.
  3. Restart Obsidian and enable Aion Codex under Settings → Community plugins.
  4. In a note, run Aion Codex: Insert example Chronicle from the command palette. Alternatively, copy the bundled Example.md into your vault.
  5. Open Reading View or Live Preview to see the Chronicle. Use Source Mode for direct Markdown editing.

No dependency installation or build step is needed to use the bundled plugin. The minimum declared Obsidian version is 1.5.0.

Markdown format

A Chronicle uses ordinary Markdown structure inside a custom fence:

MarkdownAion conceptDisplay
#AgeSection heading
Text beneath the Age headingAge DescriptionOverview beneath the heading
##Year/Time LabelLeft column
###Circa/Date LabelHeading in the Events box
-EventEvent beneath that Date

For example, two linked Ages:

```aion-timeline
```aion-timeline
<!-- aion: chronicle/starting -->
# Age of Stars
<!-- colour: #af0000 -->

An overview of the Age, with **emphasis** and [[World history]].

## 1,000,000 BCE
### 11 Rainwake
- A traveller records the falling star.
- The council gathers to discuss its meaning.
```

```aion-timeline
<!-- aion: chronicle/age-2 -->
# Age of Dragon
<!-- colour: #000080 -->

When Dragons ruled the skys.

## 10,000 BCE
### Circa
- The Lord of All Dragon conquered the skies.
- The first settlements appear.
```

```aion-timeline
<!-- aion: chronicle/age-1 -->
# Age of Man
<!-- colour: #008000 -->

## Year of the Silver Crown
### Winter's End
- A new ruler is crowned.
```

```aion-timeline
<!-- aion: chronicle/age-3 -->
# What Is Yet to Come

## Future
### Prophecy
- The lost city will rise again.
```
```

The shared chronicle identifier links the blocks; starting and age-2 identify their individual parts. Keep each part identifier unique. Use another Chronicle identifier for an independent Chronicle. Linking works within one note, not across notes.

New Chronicles and Ages created through Aion use one linked block per Age. Blocks render in place, so surrounding note text stays where you put it. Age order follows the note, with the Starting Age exception described below. Older independent blocks remain supported; adding an Age to one creates linked Age blocks.

Year and Date labels are free text. Numbers and recognised calendar names are only needed if you want to use the relevant sorting button. Age titles must be unique within a Chronicle; separate Chronicles may reuse titles.

Events support Markdown formatting and Obsidian note links, including [[links|aliases]]. Indent continuation lines by two spaces. Images and embeds are suppressed in Events, and there is no Year image field.

Age Descriptions support paragraphs, emphasis, lists and links. Structural timeline headings, metadata and fences are reserved. Unsupported content outside the documented structure produces an error rather than being silently discarded by a form edit.

Adding and editing

The shared toolbar provides search, Add Age and Add Event. Each Age has its own Add Event, Edit Age and Delete Age controls.

The Age dialog contains:

  • Age Title
  • Starting Age
  • Age Description
  • Age Timeline Colour, with Use Default to follow the global colour

The Event dialog contains Age, Year/Time Label, Circa/Date Label and the Event description. Matching Year and Date labels reuse their existing groups.

Hover over an Event or focus it to reveal Add, Edit and Delete icons. Add Event preselects that Event's Age, Year and Date and inserts the new Event directly beneath it. You can change its destination in the dialog. On touch devices, tap the Event row to reveal its controls.

Deleting an Event requires confirmation. Deleting an Age warns that all its associated Years, Dates and Events will also be deleted and shows the Event count. Empty containers are removed when an Event edit, move or deletion empties them; the Age remains available.

Form edits and drag/drop save back to the Markdown note. Aion checks that the content has not changed since the operation began and refuses stale writes. There is no separate in-plugin undo system.

Drag/drop

Insertion lines preview where content will land. Clear search before dragging.

Drag sourceWhat moves
Event textThat Event
Date headingThe Date and all its Events
Year labelThe Year and all its Dates and Events
Age titleThe Age heading, description and colour boundary
Age title with Ctrl held when droppingThe entire Age and its contents

An ordinary Age drag redefines where that Age starts. It can be placed between Dates; the Events left behind belong to the Age heading now directly above them. Splitting a Year repeats its label under the new Age. A move that would leave content without an Age is refused.

A Ctrl-drag moves a whole Age between Age sections. Event, Date and Year drops support before/after positions and empty destinations. Matching Year labels merge their Dates; matching Date labels merge their Events. Repeated Event text is retained, and dragging does not apply chronological sorting.

Movement works across linked Age blocks in the same Chronicle. Dedicated timeline drag handles are not used. Mouse dragging on desktop is the primary target; direct Markdown editing remains available for other workflows.

Starting Age

Select Starting Age in the Age dialog to move that Age and its contents to the beginning of the Chronicle. Only one Age can have this designation, and its Years and Dates are never sorted.

Moving an Age into first position through drag/drop automatically makes it the Starting Age. Unchecking the option clears the designation without moving it. Deleting a designated Starting Age transfers the designation to the next Age, if one remains.

Its linked marker uses the reserved part name starting, for example <!-- aion: chronicle/starting -->. Free-text Year/Time Labels remain available for beginnings outside a numbered calendar.

Search

Search covers Age titles and descriptions, Year labels, Date headings and Event text, retaining their surrounding context.

For a linked Chronicle, results from all Ages appear beneath the first block's search bar, even if later blocks have not yet loaded on screen. Other blocks do not duplicate the results. The clear button inside the search field restores each Age to its own position.

Clear search before sorting or dragging. Matching Events can still be edited through their controls.

Sorting and custom calendars

Sorting is deliberately manual, so you can arrange and edit content before putting it in calendar order. Ages are never chronologically sorted.

Under Settings → Aion Codex → Sorting, configure:

  • First Era: defaults to BCE, labelled Negative Years.
  • Second Era: defaults to CE, labelled Positive Years.
  • Months: an initially empty, ordered list of your calendar's Month names. Add with the plus button or Enter, edit names directly, remove with the trash icon and drag the list grips to change Month order.

Sort Years

Use Sort Years beside an Age heading to sort only that Age's Years.

With both Eras defined, the first Era counts down, followed by the second counting up. For example: 1,000 BCE → 500 BCE → 1 CE → 100 CE. A numeric Year without an Era belongs to the upward group. Era matching ignores case, and comma-separated numbers and attached Era suffixes are supported.

With zero or one Era defined, signed numeric Years sort from negative to positive, regardless of trailing Era notation.

Named Years and unrecognised labels keep their existing slots while recognised Years sort around them. Equal values keep their relative order. Dates and Events travel with their Year; sorting does not merge Years.

Sort Dates

Use Sort Dates at the top right of an Events box to sort that Year's Date groups.

  • Circa comes first.
  • Recognised Dates follow the configured Month order.
  • A Month without a Day comes before numbered Days in that Month.
  • Both Day-first and Month-first formats are accepted, such as 11 Rainwake, Rainwake 11, 11th Rainwake and Rainwake 11th.
  • Custom and multiword Month names are supported. Positive integer Days are accepted without imposing Gregorian Month lengths.

Unrecognised Dates keep their slots among the non-Circa Dates. Equal values keep their relative order. Labels are not rewritten, Date groups are not merged, and Events within a Date are not sorted. Without configured Months, only Circa can be moved into order.

The Starting Age has neither sorting control. Adding, editing and reopening a Chronicle never trigger sorting automatically.

Appearance settings

The General tab provides:

SettingDefaultRange
Age Text Size140%100–150%
Year Text Size100%90–110%
Date Text Size120%100–120%
Event Text Size80%75–95%
Year Column Width150px100–250px
Space between Years10px5–25px
Default Timeline ColourRGB 175, 0, 0 (#af0000)Colour picker
Shaded Event panelsEnabledOn/off

Text-size controls use 5% steps relative to document text size. Age Descriptions remain at 100%. Text-size changes update visible Chronicles immediately; reopen the note for other appearance changes.

Fonts follow the Obsidian theme and CSS snippets. Date headings are bold. Event bullets align with the Date heading's left edge, and narrow screens use a compact Year column.

Default and individual Age colours adapt to Light and Dark modes. They colour the dots, panel borders and drag indicators. The main timeline line and panel shading share the same neutral, theme-aware grey. Use Default removes an Age's colour override so it follows future global colour changes.

Settings are stored per vault in the plugin's data.json; Chronicle content and individual Age colours stay in Markdown.

Customising the example Chronicle

Insert example Chronicle reads Template.md from the installed Aion Codex folder each time it runs. Edit that file to change your starting template; no rebuild or restart is needed.

Insertion assigns fresh Chronicle identifiers to avoid linking to an existing Chronicle accidentally. It preserves the template's content and does not modify Chronicles already inserted. Missing or invalid templates insert nothing and show an error.

Performance and current scope

The author's Infusion Chronicle currently contains 804 Events, with no issues reported in its current use. This is a real-use report, not a performance guarantee for every device, theme or plugin combination.

Each linked Age renders independently. Rich Markdown formatting is deferred until Events approach the viewport and processed in small batches. Unchanged formatted content is reused where possible, and Event controls are shared rather than duplicated for every Event. Search still covers the full Chronicle.

Reading View and Live Preview use Obsidian's normal code-block processor. Source Mode remains editable fenced Markdown, with no custom editor syntax extension. Separate Age blocks also avoid keeping the entire Chronicle inside one very long fence; exceptionally large individual blocks may still encounter Obsidian's own editor limits.

Aion currently focuses on authoring and displaying Chronicles. It does not provide a calendar grid, cross-note aggregation, automatic sorting, duration bars or Xmind conversion. Mobile drag/drop has not been established as a supported workflow.

Development

The installable main.js is bundled from the local source files. It has no external runtime dependencies beyond Obsidian.

From the plugin directory, rebuild with node build.js. The build also mirrors Template.md to Example.md; edit the template rather than the generated example.

Run the automated checks with:

node --test *.test.js

Checks cover parsing, saving, dialogs, linked blocks, search, sorting, rendering and drag/drop logic. Simulated checks do not replace testing inside Obsidian with real themes and pointer input.

See CHANGELOG.md for the retained release history.