Nora HTML Exporter

by singhaf9270
5
4
3
2
1
Score: 50/100
New Plugin

Description

Reviews

No reviews yet.

Stats

0
stars
downloads
0
forks
0
days
0
days
0
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
15
commits

Latest Version

11 hours ago

Changelog

✨ What's New

  • Single-File Folder Export: Folder export now combines all Markdown files in the selected folder into one standalone HTML document.
  • No More Separate HTML Files: Exporting a folder no longer generates one HTML file per Markdown note.
  • Unified Reading Experience: All notes are organized into separate sections within one document, with a shared table of contents.
  • Simplified Export Interface: Removed the separate merged-export button. The main folder export action now creates one combined HTML file.

🔧 Improvements

  • Updated Persian and English interface labels and descriptions.
  • Updated the README with the new folder export workflow.

📦 Installation

Download main.js, manifest.json, and styles.css and place them in your .obsidian/plugins/nora-html-exporter/ folder.

Restart Obsidian or reload plugins to apply the update.

README file from

Github

Nora HTML Exporter

Create beautiful, standalone HTML reading experiences from your Obsidian notes. Nora supports Persian and English interfaces, right-to-left and left-to-right layouts, interactive reading tools, and offline-friendly attachment embedding.

Features

  • Single-note export: Export the current Markdown note with a customizable cover and reader appearance.
  • Quick export: Generate HTML using your saved defaults.
  • Folder export: Combine every Markdown note in a selected folder into one complete HTML document. Each note starts a new chapter in the shared reader. Choose the chapter heading level from H1 to H6. Folder export creates one HTML file, not one file per note.
  • Nested folders: Include subfolders when exporting a folder.
  • Attachment embedding: Embed local Vault images and supported attachments as Base64 data so exported documents can work offline.
  • Live preview: Preview a note in an Obsidian side panel.
  • Bilingual interface: Persian and English plugin UI and exported reader.
  • Reader customization: Light/dark mode, color palettes, cover styles, text direction, font size, and page width.
  • Interactive reader: Table of contents, text search, bookmarks, highlights, annotations, footnotes, and print/PDF support.
  • Frontmatter metadata: Use note metadata for the exported cover and document details.

Installation

Community plugins

Once published, install Nora HTML Exporter from Obsidian's Community plugins browser.

Manual installation

  1. Download main.js, manifest.json, and styles.css from the latest GitHub release.
  2. Create a folder named nora-html-exporter inside your Vault's .obsidian/plugins/ directory.
  3. Place the three files in that folder.
  4. Reload Obsidian and enable Nora HTML Exporter in Community plugins.

Usage

Export one note

Open a Markdown note and use the Nora ribbon button, the command palette, or the note context menu. Choose the full export dialog to customize the cover and reader, or use Quick export to apply your defaults.

Export a folder as one HTML file

  1. Run Batch export a folder to HTML from the command palette, or right-click a folder.
  2. Select the source folder.
  3. Enable Include subfolders if nested notes should also be included.
  4. Click Export Entire Folder as One HTML.
  5. Nora combines all selected Markdown notes into one standalone HTML reader. Each file starts a new chapter, and you can choose the heading level (H1–H6) in plugin settings. The generated chapter titles are used to split the reader into sections.

The result is exactly one .html file for the selected folder, regardless of how many Markdown notes it contains. It is saved under the configured export directory, inside a folder named after the source folder.

Settings

Open Settings → Nora HTML Exporter to configure:

  • Plugin interface language (Persian, English, or automatic)
  • Default exported reader language
  • Export destination folder
  • Default document type, theme, palette, and cover style
  • Default text direction
  • Automatic attachment embedding
  • Opening exported HTML after creation
  • Chapter heading level for merged folder exports (H1–H6)

Community and support

The plugin settings include quick links to the ObsidianTut channels on Bale, Telegram, and YouTube, plus an optional link to support development.

Offline attachments

When Embed Vault images & attachments is enabled, Nora attempts to embed referenced local Vault files into the HTML document. This makes the output portable and suitable for offline reading. Large media files can significantly increase the resulting HTML file size. Remote web links still require an internet connection.

Compatibility

  • Obsidian desktop and mobile (the plugin manifest does not restrict the platform).
  • Minimum Obsidian version: 1.4.0.

Some operating-system browser-opening behavior is desktop-only; exported files can still be opened manually on mobile.

Development

The plugin is implemented in JavaScript and uses the Obsidian plugin API. The repository includes:

  • main.js — plugin logic and standalone HTML reader generator
  • styles.css — plugin modal, settings, and preview styles
  • manifest.json — Obsidian plugin metadata

License

No license file is currently included in this repository. Please check with the repository maintainer before redistributing or modifying the project.