Any-RTL

Smart RTL support for mixed-language notes in Obsidian.

Any-RTL provides flexible right-to-left (RTL) and left-to-right (LTR) direction handling for Obsidian, with content-aware detection for mixed-language notes.

✨ Features

• 🔄 Multiple direction modes
  • Auto — follow Obsidian's automatic direction detection.
  • Any-RTL — use RTL when a line contains any RTL character; otherwise use LTR.
  • LTR / RTL — force a specific direction.
• 📄 Per-file direction — remember the selected direction for individual notes.
• 🏷️ Frontmatter support — control a note's direction directly from YAML frontmatter.
• 📝 Mixed-language content — handle Persian, Arabic, Hebrew, English, and other RTL/LTR content within the same note.
• 👁️ Reading Mode support — apply direction handling to rendered notes.
• 📏 Flexible detection — choose between per-line and per-block direction handling.

---

📦 Installation

🌐 Community Plugins

1. Open Settings → Community plugins → Browse.
2. Search for Any RTL.
3. Click Install, then Enable.

🧪 BRAT

For the current development version:

1. Install BRAT from Community Plugins.
2. Open Settings → BRAT → Beta Plugin List.
3. Add https://github.com/zamanimm/obsidian-Any RTL
4. Install and enable Any RTL.

🛠️ Manual Installation

1. Download the latest release from [GitHub Releases](https://github.com/zamanimm/obsidian-Any RTL/releases).
2. Create the plugin folder:

.obsidian/plugins/any-rtl/

3. Place these files inside the folder:

main.js
manifest.json
styles.css

4. Restart Obsidian or reload the plugins.
5. Enable Any RTL from Settings → Community plugins.

---

🎯 Direction Modes

Mode	RTL character present	No RTL character	Behavior
LTR	LTR	LTR	Force left-to-right
RTL	RTL	RTL	Force right-to-left
Auto	Depends on the first strong directional character	Depends on the first strong directional character	Follow Obsidian’s automatic direction detection
Any-RTL	RTL	Depends on the first strong directional character	RTL if any RTL character is present

• Based on Obsidian's built-in direction detection.

---

🔍 Any RTL Detection

A line is treated as RTL if it contains at least one RTL character:

📝 Example

سید علی

سید ali

seyed علی

seyed ali

This is particularly useful for mixed-language content where RTL and LTR text appear in the same line.

---

📝 Per-Note Direction

Notes use the Default text direction unless a saved per-note direction or frontmatter override applies.

To remember a note’s direction without modifying its Markdown file:

1. Enable Remember text direction per file in Settings → Any-RTL.

2. Open the note and click the status bar’s direction indicator, or use the plugin’s text-direction command, to cycle through LTR → RTL → Any-RTL → Auto.

Your selection is saved in the plugin’s data.json and restored when the note is reopened. Disabling this setting makes notes use the default direction unless frontmatter specifies otherwise.

🏷️ Frontmatter Override

Set a note’s direction explicitly using YAML frontmatter:

---
direction: any-rtl
---

Supported values: rtl, ltr, auto, and any-rtl.

A valid frontmatter direction takes priority over saved per-note directions and the global default. UI changes do not modify frontmatter. With per-file remembering enabled, your selection is still saved, but frontmatter takes precedence when the note is reopened.

Reset to Default

Close Obsidian and remove the note’s entry from fileDirections in:

<Vault>/.obsidian/plugins/any-rtl/data.json

Also remove any direction property from the note’s frontmatter.

---

⚙️ Settings

Configure Any RTL from: Settings → Any RTL Available options include direction mode, detection behavior, per-file direction, and Reading Mode handling.

---

🙏 Credits

Any RTL builds on ideas and implementation patterns from these open-source Obsidian plugins:

• Content RTL by Sirwan Afifi
• RTL Support by ESM 7 and contributors Both projects are released under the MIT License. Their original copyright and license notices are retained where applicable. Thank you to the authors and contributors of these projects for their open-source work. ❤️

---

📄 License

MIT License. See License for details.