中文

siyuan-plugin-importer

Import md, epub, docx, html, etc. into Siyuan notes. Currently supported formats: .md, .epub, .docx, .html, .opml.

✨ After two years, we are back with our first update. Due to work commitments, plugin maintenance was temporarily suspended, which caused inconvenience for some users. We sincerely apologize for this 🙏. The plugin is now back under active maintenance and fully functional 🚀.

📌 Please upgrade to siyuan-note 3.1.12 or higher to use the plugin ⚡

Core Features

• Select Notes: Support for selecting a notebook, the next time you open it, you can automatically remember the notebook you selected last time
• One-click import: Select a file, one-click import, zero configuration
• Parameter configuration: Support disabling the built-in text processing, support powerful custom processing function configuration, how to handle the converted MD text, it is completely up to you.

FAQ

• Q1：How to install the import tool plug-in? Where can I find his entrance after installation?

  A1：Find Marketplace->Plugins->Importer download and enable.

  After the installation is complete, find the Importer icon on the top right toolbar, and click to follow the pop-up window.

• Q2: Can MOBI files be supported? Can Markdown folders be supported?

  A2: Refer to #31, you can first use https://products.aspose.app/words/conversion/mobi-to-md conversion, and then use the import folder that comes with the notebook to implement.

  Notes have been imported into the Markdown folder function, this function please use the notebook's own import directly.

  The plug-in only does enhancement to solve the problems that are not solved by the ontology, and for these overlapping functions, the plug-in does not do it for the time being.

• Q3: Can I support docker or mobile?

  A3: Sorry. Limited by Pandoc, Docker and mobile are not available on time. Please use the PC client.

Changelog

1.8.1 (2025-06-18)

Bug Fixes

• Optimize styles and improve import settings
  • Add scoped attribute to styles in ImportForm and ImportSetting components
  • Organize styles in a more structured and modular way
  • Adjust styles for better visual consistency
  • Update import setting styles for improved user experience
  • Make minor adjustments to context menu and other related styles
• Update Chinese translation for better localization

1.8.0 (2025-06-15)

Bug Fixes

• Fix import issues in new version

Features

• Add tab navigation for import settings

Code Refactoring

• Remove unused components and update styles
• Migrate from Svelte to Vue 3

1.7.0 (2023-06-25)

Features

• Compatible with API changes in version 292
• Conversion parameter changed to GFM

v1.6.0 major update

Features

• #47 Import html support images (870b5fb)
• Optimize pandoc parameters (6e0ca9f)
• Optimize icon, new icon, new weather (d188b74)
• Optimize help documentation (b626917)
• Optimize interface interaction (ef435aa)
• Optimize conversion parameters (843446a)
• Upgrade siyuan to 0.7.2, compatible with latest api, solve ismobile error problem (531628f)
• Import md support resource files (33a20c7)
• Support custom processing functions, support disabling built-in processing functions (f5452e2)
• Add custom processing function configuration (f4a28a7)
• Display temporary folder path, support desktop and desktop browsers (bc8c878)
• Adjust the compatibility, the minimum version is 289, only support desktop (93761c9)

v1.5.3 major update

• Optimize the icon display on the mobile terminal, note: there is no pandoc on the mobile terminal, and the import function is temporarily unavailable

v1.5.2 major update

• hash temporary path lowercase (38a2972)
• New verification, temporary files must be cleared before batch import (508999d)

v1.5.1 major update

Features and bug fixes

• #33 Support batch import of selected directories (2e58a37)
• #38 line break problem(74c00c0)
• Uninstall does not delete configuration (a913034)
• Support manual cleaning of temporary files (5687248)
• Support md file import, md does not need to be converted, other formats, convert first, then import

Development refactoring

• Move the i18n folder to the src directory (0234c50) v1.5.0 major update

• Solve the problem that after importing epub, the pictures in it will appear in the unreferenced resources, which are easy to be cleared by mistake. Now after the document is imported, the resource files will not appear in the unreferenced ones. Unreferenced resources are visible after the document is deleted.
• Repeated imports now create new articles
• The resource file is not named in the custom hash, directly let the import API handle it by itself

v1.4.1 major update

• Optimize link removal rules
• Block some notebooks

v1.4.0 major update

In short, this version is strongly recommended for all users to upgrade, to prevent resource files from being unable to cross-platform due to previous path problems, and to have a better user experience in other aspects.

• Fix the problem that Windows path replacement does not take effect For example, the converted path: C:\Users\terwer\Documents\mydocs\SiyuanWorkspace\public\data/assets/import/cover.jpeg Now, on the Windows platform, it can be displayed normally as: /assets/import/cover.jpeg

• A new hash is added to the path to prevent the image from being overwritten when multiple files have the same image, for example: /assets/import/1nMELS/cover.jpeg

• The directory link generated by pandoc is not clickable, temporarily removed

• The pandoc footnote cannot be jumped, temporarily remove it to keep the title clean

• Fix the abnormal display problem of the top svg in some scenes

v1.3.0 major update

• Support image import

v1.2.0 major update

• Support text import
• Remove some redundant blank lines

For more update records, please check CHANGELOG

Donate

If you approve of this project, invite me to have a cup of coffee, which will encourage me to keep updating and create more useful tools~

Wechat

Alipay

Thanks

Thanks to siyuan-note and pandoc for their strong support for this plugin