Markdown Reader Support

[Heroor]

💡 Need Help? We’re Here to Support You!

Hello, Markdown Reader users! 👋

If you’re experiencing issues, have questions, or need assistance with Markdown Reader, you’ve come to the right place. Let’s make sure you have the best experience possible! 🌟

---

📌 Common Topics We Can Help With:

1. Installation Problems

   • Trouble installing Markdown Reader in your browser?

2. Feature Questions

   • Not sure how to enable or configure specific plugins?

3. Bug Reports

   • Encountered unexpected behavior?
   • Let us know what’s happening so we can fix it!

4. Customization Requests

   • Looking for specific settings?

5. General Questions

   • Anything else we can assist you with?

---

🛠️ How to Get Support

To help us resolve your issue quickly, please provide the following:

1. A clear description of the problem:

   • What were you trying to do?
   • What went wrong?

2. Your setup:

   • Browser name and version.
   • Operating system (Windows, macOS, Linux, etc.).

3. Steps to reproduce (if applicable):

   • How can we recreate the issue on our end?

4. Screenshots or error messages (if available):

   • These are super helpful for understanding the problem!

---

📬 Ways to Contact Us

Post your question or issue in this thread, and we’ll reply as soon as possible.

---

Thank you for reaching out! We’re here to make Markdown Reader the best Markdown experience for you. 🙌

Looking forward to helping you,

The Markdown Reader Team

[Heroor]

💡 需要帮助？我们随时为您提供支持！

亲爱的 Markdown Reader 用户，您好！👋

如果您在使用 Markdown Reader 时遇到问题、有疑问或需要帮助，来这里看看！让我们一起确保您获得最佳的使用体验！🌟

---

📌 我们可以提供帮助的常见话题：

1. 安装问题

   • 在浏览器中安装 Markdown Reader 时遇到困难？

2. 功能疑问

   • 不清楚如何启用或配置特定插件？

3. 错误报告

   • 遇到意外的行为？
   • 告诉我们发生了什么问题，以便我们修复它！

4. 定制化需求

   • 想要特定的主题或设置？

5. 其他疑问

   • 任何其他需要我们协助的事项？

---

🛠️ 如何获得支持

为了帮助我们快速解决您的问题，请提供以下信息：

1. 清晰的问题描述：

   • 您在尝试做什么？
   • 出现了什么问题？

2. 您的设备信息：

   • 浏览器名称和版本。
   • 操作系统（Windows、macOS、Linux 等）。

3. 重现步骤（如适用）：

   • 如何在我们的设备上重现问题？

4. 截图或错误信息（如有）：

   • 这些对理解问题非常有帮助！

---

📬 联系我们的方式

在本帖中发表您的问题或意见，我们会尽快回复。

---

感谢您的反馈！我们将竭尽全力为您提供支持，让 Markdown Reader 成为您的最佳 Markdown 工具！🙌

期待为您提供帮助

Markdown Reader 团队

[Heroor]

Failed to Preview Local File

Allowing File Access Permission

For Chrome

1. Open Chrome's extensions management page: Go to chrome://extensions/ in the address bar.
2. Find the installed Markdown Reader extension and click on Details.
3. Scroll down to find the Allow access to file URLs option.
4. Enable this option.

Note: Chrome, by default, restricts extension access to local files. You need to manually enable this permission in order to preview local markdown files. Markdown Reader only reads and renders markdown files and does not modify or upload user data. You can enable this option with confidence.

For Firefox

By default, Firefox allows local file access. Ensure your file path starts with file://, for example: file:///C:/path/to/your/file.md.
If you encounter issues, check for any potential restrictions, such as enhanced privacy settings, that might limit file access.

---

无法预览本地文件的解决办法

开启本地文件访问权限

在 Chrome 中

1. 打开 Chrome 的扩展程序管理页面：在地址栏输入 chrome://extensions/。
2. 找到已安装的 Markdown Reader 扩展程序并点击 详细信息。
3. 向下滚动，找到 允许访问文件网址 选项。
4. 启用此选项。

注意：Chrome 默认禁止扩展访问本地文件，您需要手动启用此权限，以便正常预览本地 Markdown 文件。Markdown Reader 仅读取和渲染 Markdown 文件，不会修改或上传用户文件数据，可以放心开启。

在 Firefox 中

默认情况下，Firefox 支持本地文件访问。确保您的文件路径以 file:// 开头，例如：file:///C:/path/to/your/file.md。
如果遇到问题，请检查是否有其他潜在的限制，例如增强的隐私设置，可能会限制文件访问。

[Heroor]

Unable to Preview HTTP Links

Check MIME Type Configuration

When trying to preview a markdown file from an online URL or local server, it's important to ensure that the correct MIME type is set for markdown files. If the MIME type is incorrectly set, the browser may treat the resource as an unknown file type and attempt to download it instead of displaying the content.

Common Correct MIME Types

• text/markdown
• text/plain

These MIME types allow the browser to recognize and display the markdown content properly. If the MIME type is set to application/octet-stream or another unknown/incorrect type, the browser may prompt for a download instead of rendering the file.

How to Fix This

• For online resources: If you're using an online server to host the markdown file, make sure the server is configured to send the correct MIME type in the response headers.
  • For example, if using Apache, you can add the following line in your .htaccess file:

    AddType text/markdown .md
    

• For local server setup: If you're hosting markdown files locally (for example, with a local web server), ensure that the server is configured to serve the correct MIME type for .md files.

Tip: If the issue persists, you can check the file's response headers using the browser's developer tools (Network tab) to confirm the MIME type.

---

无法预览 HTTP 链接的解决办法

检查 MIME 类型设置

当尝试从在线 URL 或本地服务器预览 markdown 文件时，确保服务器返回正确的 MIME 类型非常重要。如果 MIME 类型设置不正确，浏览器可能会将该资源视为未知文件类型，并尝试下载它，而不是展示内容。

常见的正确 MIME 类型

• text/markdown
• text/plain

这些 MIME 类型让浏览器能够正确识别并展示 markdown 内容。如果 MIME 类型被设置为 application/octet-stream 或者浏览器未知的非法类型，浏览器可能会弹出下载提示，而不是渲染文件。

如何修复

• 在线资源：如果您使用在线服务器托管 markdown 文件，请确保服务器设置了正确的 MIME 类型返回文件。
  • 例如，若使用 Apache 服务器，可以在 .htaccess 文件中添加以下内容：

    AddType text/markdown .md
    

• 本地服务器设置：如果您在本地服务器上托管 markdown 文件（例如使用本地 Web 服务器），确保该服务器配置为正确提供 .md 文件的 MIME 类型。

提示：如果问题仍然存在，可以使用浏览器的开发者工具（网络标签）检查文件的响应头，确认 MIME 类型。

[HHN0609]

好奇，大佬是怎么绕过CSP白名单机制，把脚本注入到web页面，然后把渲染好的MD注入进页面的

[Heroor]

脚本注入是扩展程序去执行的，所以不会有 CSP 问题，剩下的就是处理页面内容的逻辑了，没有很复杂，这个组织里保留了2.0版本的仓库，可以参考一下源码

[HHN0609]

我content-script里的文件会被拒绝😂。还有想借此问下，大佬是如何做到让页面不闪动的，还有如何判断https://github.com/mozilla/pdf.js/blob/master/README.md，这样的连接

[Heroor]

对了，你的 content-script 文件是多个 bundle 吗，如果是的话可以调整一下你构建的配置，content-script 只打成单个 js 文件，不要有异步 js 的加载；还有一种办法是使用 chrome-extension:// 协议的绝对路径加载你扩展程序文件，应该不会遇到 CSP 限制，相对比较麻烦，可以尝试。

页面闪动我不太清楚你说的是哪种情况，可以在适当的时候用一些 loading 或者骨架屏之类的做过渡吧。

URL 的判断可以在 manifest 里设置给 content_scripts.matches，让插件只在你允许的 URL 下运行，这样可以省去很多判断；不然就手动匹配一下 URL，正则写对应该就行了。

[HHN0609]

thanks

[StrollStars]

请问可否支持网页渲染，比如一些在线记事本，用MD写，如果没有大纲栏标题的效果就打折扣。

[StrollStars]

既然提到了HTML与markdown的互转，想顺带请教下，对于网页的保存，相比markdown，还是用HTML本身更合适对吧？

我个人也觉得，如果网站本身能实现是最好。我非程序员，不知道对于网站本身而言，这个实现起来是不是比较麻烦，因为目前接触到支持markdown格式的网站都没做。
不过现在借助AI，应该做起来比以前容易得多吧，目前打算用JavaScript脚本去实现。

感谢告知Note.ms添加.md的方式能用markdown去渲染，没提醒还真发现不了。

[Heroor]

markdown 其实只能算作是 HTML 的"子集"吧，或者说是 XML 的子集？毕竟 markdown 最后也是要被渲染成 HTML 页面的，HTML 的表现力终究还是比普通的 markdown 语法要强很多的，当然也要配合 CSS JavScript 等等。还有些 markdown 框架或库 甚至可以集成一些自定义前端组件，拉高了 markdown 的天花板。

然后你说的网页保存，是指你想把笔记类的内容保存成网页吗？如果是这样的话，写 markdown 还是现在比较主流的编写方式，比如现在的个人博客网站也是用一些 markdown 解析工具将 md 写的文章渲染成 HTML 博客页面的。（不过用 HTML 记笔记这事我真干过。。。）

开发一个解析大纲的浏览器扩展还是相对容易的，之前是不是程序员也没关系，就当这是你入门的一个机会吧～～

我有空也会再尝试下有没有别的方法为这两个网站做兼容，如果有好消息我会来告诉你！

[StrollStars]

是的，markdown的语法简洁或者说简单，几分钟就可以看完，纯HTML都比它复杂多了。至于框架和库甚至是自定义前端组件，它的兼容性就差了吧？或者只局限于当前平台？

我说的网页保存，就是字面意思，就是把网页保存到本地，方便离线查看以及防止链接失效。
我目前保存的是网页格式，但是有些浏览器扩展是把网页保存成markdown格式的。

你的意思是用扩展而不是脚本的形式实现更好是吗？我当初还想用CSS，但怎么想都觉得不可能。

感谢你的指教，我试试，有问题再来请教。
我目前写笔记是用的markdown语法，因为简洁高效，如果用HTML，怕会打断思路。

[Heroor]

你用的保存为 md 格式的工具，可能它是把网页的主要信息导出为 md 了吧，不知道转换效率高不高，这个看个人喜好吧。想离线查看原网页，我感觉其实就直接浏览器 ctrl+s 保存就最省事了。

回到解析大纲的问题，如果你想再简单点，可以直接写写油猴脚本，配合一些css应该就行了，AI 应该可以帮助你完成，加油💪！

[StrollStars]

浏览器ctrl+s保存，如果是单一文件只能保存成mht格式，这个格式已经过时了，所以一般都是通过第三方扩展，另一方面还能压缩。md除了效率，怕还会丢失网页的一些样式。

哈哈，那我就先试试油猴脚本，谢谢指教。

[philiprhoades]

Why am I still blocked? I have signed up for the Pro trial but I still can't see my files from Brave browser using:

file:///home/phr/

This dir list is greyed out and the upgrade popup can't be closed.

UPDATE: IT IS WORKING NOW - IT TOOK SOME TIME TO ALLOW ME ACCESS!

Phil.

[Rikuron]

Just curious if this extension can support rendering tables? I'm trying to type it like this but it's not rendering for me:

| Name | Age | Role |
|------|-----|------|
| Ken  | 21  | Dev  |

Did I do something wrong here?

[Rikuron]

The others are rendering normally. I've also tried it with Chrome but the results are the same.

[Heroor]

This is extremely confusing. If it's just the absence of any rendering in the table, I've never encountered such a situation before. Is there any error message displayed in the browser's console?

[Rikuron]

No errors seen in my console

[Rikuron]

OH OKAY I FIGURED IT OUT! It was an error in the way I wrote the markdown file itself. Thank you for your replies and the concern, I appreciate it!

[Heroor]

If it can be solved, that would be great! I’ve started doubting myself, hahaha

[zhangfanpc]

需要升级到 mermaid 的最新版本11.10、最好是有一个自动升级的选项。当前是Syntax error in text mermaid version 11.4.1

[Heroor]

收到，近期会尝试升级👌

[DRNadler]

We Need Tables!!!
Everything else is working fine, but not tables.
Thanks!
PS: Works if I add the header separation line! That's optional, right?
tableNFG.md

[Heroor]

The table can be rendered normally, but it is necessary to add the |--|--| divider line for it.

[DRNadler]

OK, thanks - I thought separator was optional...
Thanks for the nice work!