Markdown 工作流
怎么在本地读整个 .md 文件夹？
渲染、免安装
你有一整个文件夹的 .md 文件：解压的 repo docs、一堆导出笔记、一个剪藏归档。你想浏览并阅读它们，渲染好的、表格和图片都显示，而不是一个一个地盯着源码看。这里讲怎么在浏览器里打开整个文件夹，带文件树、什么都不装、什么都不上传。
为什么一个 md 文件夹不好读
常见的几条路各有毛病。纯编辑器一次开一个文件、显示的是源码。GitHub 渲染得漂亮，但得先把仓库 push 上去。MkDocs 这类静态站生成器能渲染整个文件夹，但要配置、要构建。有时你只想指着磁盘上的一个文件夹、直接读它。
在浏览器里打开这个文件夹
NoteLoom 在浏览器里打开一个本地文件夹，给你一个文件树、外加你点开什么就渲染什么。
- 用 Chrome / Edge / Arc 打开
app.noteloom.cc。什么都不用装。 - 挂载那个装
.md的文件夹（如果是下载的.zip，先解压）。 - 用侧栏文件树浏览，在
reading视图里打开任意文件、渲染着读。
| 你想要 | 在 NoteLoom 里 |
|---|---|
| 浏览集合 | 文件夹里 .md 文件的侧栏文件树 |
| 读一个文件 | reading 视图里渲染：GFM 表格、任务列表、脚注 |
| 图片 | 因为挂了文件夹，本地图按相对路径渲染 |
| 想改就改 | source / live / reading 三视图，存回同一文件 |
图片是最舒服的部分：因为你挂了文件夹，一篇用相对路径引用本地图片的笔记会把图渲染出来、而不是裂图。全程本地、什么都不上传，而且可离线。
诚实的边界
- 它打开文件夹，不打开
.zip。先把下载的仓库或导出包解压，再挂载文件夹。 - 它是阅读器和编辑器，不是文档网站。它不从你的标题建导航、也没有全站搜索索引；它显示文件树、渲染你打开的那个文件。没有构建步骤，但不是自动生成的文档站。
- 它显示
.md和.markdown、跳过.git之类的点文件夹，所以一个仓库文件夹也读着清爽。 - 仅 Chromium 桌面。只 Chrome / Edge / Arc;Firefox、Safari、手机端暂不支持，它也不总结或改动你的文件。
适合用在
FAQ
怎么一次看整个 Markdown 文件夹？
用像 NoteLoom 这样的浏览器工具挂载那个文件夹。它显示 .md 文件的文件树、并渲染你打开的任意一个，所以你能浏览、阅读整个集合，而不是在纯编辑器里一个一个地开。
能渲染着读、图片也显示吗？
能。因为你挂的是文件夹、不是单个文件，NoteLoom 按相对路径渲染本地图片，所以笔记里的图会显示，连同 GFM 表格、任务列表和别的格式。
需要装东西或上传文件夹吗？
不用。它在 Chrome、Edge 或 Arc 里打开、本地读文件夹、什么都不上传。它还作为渐进式 Web 应用（PWA）可离线用，整个集合留在你机器上。
这像 MkDocs 或 Docsify 那种文档网站吗？
不像。它不生成一个从你的标题建导航、带全站搜索的网站。它是浏览器里的阅读器和编辑器：显示文件树、渲染你点开的 .md。更简单、没有构建步骤，但不是自动生成的文档站。
能打开一个代码仓库的 docs 文件夹吗？
能，只要它是磁盘上的一个文件夹。先解压下载的仓库（它打开文件夹、不是 .zip），再挂载。它显示 README、docs 这些 .md 文件，跳过 .git 之类的东西。
需要什么浏览器？
Chromium 系桌面浏览器：Chrome、Edge、Arc。它用浏览器的 File System Access API，Firefox、Safari 和手机端浏览器目前还不支持。
渲染着读你整个 Markdown 文件夹
用 Chrome / Edge / Arc 打开 NoteLoom，挂载一个装 .md 的文件夹，一边用文件树浏览、一边看每篇笔记连表格和本地图一起渲染。什么都不用装、什么都不上传，也不用账号。