ConvertOneNote2MarkDown常见错误解决指南：让转换过程零障碍

ConvertOneNote2MarkDown常见错误解决指南：让转换过程零障碍

【免费下载链接】ConvertOneNote2MarkDownReady to make the step to Markdown and saying farewell to your OneNote, EverNote or whatever proprietary note taking tool you are using? Nothing beats clear text, right? Read on!项目地址: https://gitcode.com/gh_mirrors/con/ConvertOneNote2MarkDown

ConvertOneNote2MarkDown是一款实用的工具，能帮助用户将OneNote笔记高效转换为Markdown格式，轻松告别专有笔记工具，拥抱清晰的文本编辑体验。本文将为你详细介绍转换过程中可能遇到的常见错误及解决方法，确保你的转换之路零障碍。

一、脚本无法加载：File ConvertOneNote2Markdown.ps1 cannot be loaded because running scripts is disabled on this system.

Windows系统出于安全考虑，默认禁用Powershell（.ps1）脚本运行。若遇到此错误，无需担心，只需为当前Powershell会话临时允许运行.ps1脚本即可。

解决方法：在Powershell中执行以下命令：

Set-ExecutionPolicy Bypass -Scope Process -Force

二、COM组件调用失败：Error HRESULT E_FAIL has been returned from a call to a COM component

出现这个错误，很可能是因为你使用的Powershell版本不兼容。Powershell7.1.x及以上版本不支持加载Win32 GAC程序集，这会导致转换过程中COM组件调用失败。

解决方法：使用Powershell5.x至7.0.x版本。你可以参考项目中的相关说明了解如何安装和运行Powershell 7.0.x版本。

三、服务器执行失败：80080005 Server execution failed (Exception from HRESULT: 0x80080005(CO_E_SERVER_EXEC_FAILURE)

这种错误通常是由于Powershell和OneNote的安全上下文不匹配造成的。当两者运行的用户权限不同时，就可能出现服务器执行失败的情况。

解决方法：确保Powershell和OneNote在相同的用户权限下运行。一个简单的方法是同时以管理员身份运行Powershell和OneNote。

四、类型未找到：Unable to find type [Microsoft.Office.InterOp.OneNote.HierarchyScope]

此错误的原因与服务器执行失败类似，也是Powershell和OneNote的安全上下文不匹配所致。

解决方法：同样需要确保Powershell和OneNote在相同的用户权限下运行，建议同时以管理员身份启动它们。

五、Publish方法调用异常：Exception calling "Publish" with "4" argument(s): "Class not registered"

遇到这个错误，说明你的系统中可能没有安装Microsoft Word。因为转换过程中，某些功能需要依赖Microsoft Word来完成。

解决方法：安装Microsoft Word，确保其正常运行后再进行转换操作。

六、Publish方法调用异常：Exception: Exception calling "Publish" with "4" argument(s): "Server execution failed Server execution failed"

这种情况可能是由于Microsoft Word的插件导致发布.docx文件失败，比如zotero插件就曾被用户报告过此类问题。

解决方法：在运行转换之前，禁用所有Microsoft Word插件。

七、Publish方法调用异常：Exception: Exception calling "Publish" with "4" argument(s): "0x80042006"

这个错误有两种可能的原因。一是Powershell和OneNote的安全上下文不匹配；二是$notesdestpath不是绝对路径。

解决方法：

1. 确保Powershell和OneNote在相同的用户权限下运行，可同时以管理员身份运行。
2. 将$notesdestpath设置为绝对路径。

八、Publish方法调用异常：Exception calling "Publish" with "4" argument(s): "The RPC server is unavailable. (Exception from HRESULT: 0x800706BA)"

出现此错误可能是Windows Defender阻止了pandoc.exe的运行。

解决方法：

1. 打开Start > Windows Security。
2. 在Virus and threat protection > Exclusions下点击Add or remove exclusions。
3. 点击Add an exclusion，浏览并添加C:\Program Files\Pandoc\pandoc.exe。
4. 如果pandoc.exe仍然被阻止，可以尝试关闭Virus and threat protection、App and browser control和Device Security下的相关设置，然后重试转换。

九、Publish方法调用异常：Exception calling "Publish" with "4" argument(s): "The remote procedure call failed. (Exception from HRESULT: 0x800706BE)"

这种错误有两种常见原因。一是转换过程中OneNote未打开；二是页面内容存在bug。

解决方法：

1. 打开OneNote并在转换期间保持其处于打开状态。
2. 创建一个新的分区，将页面复制到新分区中，然后再次运行脚本。

十、图片重命名错误：Convert-OneNotePage : Error while renaming image file name references to 'xxx.png: Illegal characters in path.

Windows Powershell ISE不支持使用\\?\前缀的长路径，这会导致图片重命名时出现路径中存在非法字符的错误。

解决方法：不要使用Windows Powershell ISE，而是使用Windows Powershell或Powershell Core。具体可参考项目的requirements部分。

通过了解并掌握以上常见错误的解决方法，你在使用ConvertOneNote2MarkDown进行转换时，就能更加顺利，轻松实现OneNote笔记到Markdown格式的完美转换。如果在转换过程中遇到其他问题，也可以查看项目的FAQ部分获取更多帮助。转换过程中，脚本会记录遇到的任何错误，以便你在转换结束后查看、修复并重新运行。祝你转换愉快！

【免费下载链接】ConvertOneNote2MarkDownReady to make the step to Markdown and saying farewell to your OneNote, EverNote or whatever proprietary note taking tool you are using? Nothing beats clear text, right? Read on!项目地址: https://gitcode.com/gh_mirrors/con/ConvertOneNote2MarkDown