Skip to content

AndreasThinks/obsidian-to-quarto-exporter

Repository files navigation

Obsidian to Quarto Exporter

This plugin for Obsidian (https://obsidian.md) allows you to export your Obsidian notes to Quarto-compatible QMD files. It provides various options to customize the export process, including date formatting, tag handling, and output file management.

Features

  • Export Obsidian notes to Quarto-compatible QMD format
  • Add creation or modification date to exported files
  • Customize date format
  • Option to include or exclude tags from Obsidian notes
  • Specify output folder for exported files
  • Choose to overwrite existing files or create new ones
  • Converts Obsidian-specific syntax to Quarto-compatible format

Installation

From the Obsidian Community Plugins

  1. Open Obsidian Settings > Community Plugins
  2. Disable Safe Mode
  3. Click Browse community plugins
  4. Search for "Quarto Exporter"
  5. Click Install
  6. Once installed, close the community plugins window and activate the newly installed plugin

Manual Installation

  1. Download main.js, manifest.json, and styles.css (if available) from the latest release in the GitHub repository.
  2. Create a new folder named quarto-exporter in your vault's plugins folder: <vault>/.obsidian/plugins/
  3. Move the downloaded files into the obsidian-to-quarto-exporter folder.
  4. Reload Obsidian
  5. If prompted about Safe Mode, you can disable safe mode and enable the plugin. Otherwise, head to Settings, third-party plugins, make sure safe mode is off and enable the plugin from there.

Usage

  1. Open the Obsidian note you want to export.
  2. Use the command palette (Ctrl/Cmd + P) and search for "Export to Quarto QMD".
  3. The plugin will create a new QMD file based on your settings.

Settings

  • Date Option: Choose to add creation date, modification date, or no date to the exported file.
  • Date Format: Specify the format for the date (e.g., YYYY-MM-DD).
  • Output Folder: Set a specific folder for exported files, or leave blank to use the same folder as the original note.
  • Overwrite Existing Files: Choose whether to overwrite existing files or create new ones with incremented names.
  • Import Tags: Decide whether to include tags from the Obsidian note in the exported Quarto file.

Development

If you want to contribute to the development of this plugin, follow these steps:

  1. Clone this repository.
  2. Run npm i to install dependencies.
  3. Run npm run dev to start compilation in watch mode.

Manually installing the plugin

  • Copy over main.js, styles.css, manifest.json to your vault VaultFolder/.obsidian/plugins/quarto-exporter/.

Support

If you encounter any issues or have feature requests, please file them in the Issues section of the GitHub repository.

License

MIT