NoteLoom 博客
Markdown 与 AI 文档实用指南
把和 Markdown 及 AI 编程文档有关的常见问题写成了一份份实战指南：怎么打开 .md、语法怎么写、怎么审阅 Agent 计划与管理规则文件，以及 AI 给的文档怎么完整保留格式。
全部是免装插件、零环境配置的做法。当你需要一个边写边看排版、直接挂载本地项目文件夹、并支持内置 AI 辅助的本地文档工作区时，可以在浏览器里直接使用 NoteLoom。
入门 · 先搞懂 Markdown
Markdown 是什么？ 一句话理解这个格式，以及为什么 AI 经常用它写回答和文档。
Markdown 文件用来干什么？ AI 输出 / README / 笔记 / 编程规则 / 写作——.md 的主要用途，和为什么选它而非 Word。
怎么就地编辑 .md、不导入进 app？ 不想被逼着先"导入库"？挂载现有文件夹、就地读写 .md，不导入、不转专有格式、文件树跳过 dotfiles，文件仍是你自己的。
Notion 导出的 Markdown 怎么打开？ 导出成 md 后是多个带子文件夹图片的 .md？解压后挂载文件夹，浏览器里离线渲染 .md + 按相对路径显示本地图，不上传。
怎么本地读整个 .md 文件夹？ 一整个文件夹的 md（repo docs/导出/归档）想像 GitHub 那样带侧栏树+图渲染读？挂载文件夹、浏览器里渲染，免安装不上传（非 docs 站）。
Google Drive 老把 .md 开成 Google Doc 怎么办？ 想编真 markdown 而不是被转成 Doc？挂载 Drive 桌面端的本地同步文件夹、就地读写真 .md，Drive 再同步；诚实不替代同步、挡不住网页端转换。
Dropbox 只让"转 Paper"、怎么编 .md？ dropbox.com 没纯文本编辑器、只让转 Paper？挂载 Dropbox 桌面端的本地同步文件夹、就地编真 .md，Dropbox 再同步；不转 Paper、不替代同步。
Markdown 怎么写？ 新手必学的基础语法，加上边写边看排版的方法。
Markdown 标题怎么写？ # 一级到六级怎么写、#标题 不生效通常是少空格、=== 下划线式，以及 --- 变标题的坑。
Markdown 下划线怎么弄？ Markdown 没有原生下划线：_ 是斜体、不是下划线。用 <u> HTML 或改用粗体/斜体/==高亮==，以及各自能不能渲染。
Markdown 斜体、粗体怎么打？ * 斜体、** 粗体、*** 两者；* 比 _ 在单词里更稳；星号显示成符号通常是多了空格。
Markdown 怎么打 emoji？ 贴 emoji 字符在哪都显示；:smile: 短代码是 GitHub 们自己的功能，多数编辑器原样显示。附各平台支持表。
md 文件开头的 --- 是什么？ 那是 YAML frontmatter（笔记属性）：标签、标题这类元数据。谁写进去的、为什么有的查看器显示成表格，以及怎么自己写。
Markdown 目录怎么生成？ Markdown 没有原生目录语法。手写锚点链接，让 GitHub 自动生成，或用大纲面板导航长文档。三条路各自怎么用。
Markdown 表格怎么写？ 表格的写法、左中右对齐、单元格换行与转义，一次讲清。
Markdown 复选框怎么写？ 任务列表 - [ ]/- [x] 语法、为什么方框点不动，以及怎么得到可点击勾选并写回 .md 的复选框。
Markdown 换行不生效？ 按回车不换行的原因，和两个空格 / <br> / 空行三种正确写法。
Markdown 分割线怎么打？ --- / *** / ___ 打出分割线，以及为什么 --- 会把上一行变成大标题（Setext 坑）。
Markdown 怎么插入图片？  语法，以及图片不显示（路径写错 / 读不到本地文件）怎么修。
Markdown 图片太大怎么缩？ 标准 md 无尺寸语法：可移植的 HTML <img width>，和 NoteLoom 的 |300 简写 / 拖拽改宽。
Markdown 代码块怎么写？ 行内代码、三反引号围栏块、加语言高亮，以及代码块不渲染怎么修。
Markdown 怎么加链接？ [文字](链接) 语法、相对 / 锚点 / 引用式链接，以及链接失效怎么修。
Markdown 列表怎么写？ 无序 / 有序 / 嵌套 / 任务清单复选框，以及列表不渲染怎么修。
Markdown 转义怎么写？ 用反斜杠让 * # _ 原样显示、别变格式；代码里不用转、下划线变斜体的坑。
Markdown 引用怎么写？ > 语法、多段引用、用 >> 嵌套、引用里放内容，以及断在半路怎么修。
Markdown 提示框（Callout）怎么写？ > [!NOTE] 提示/警告卡片：13 种类型+别名、可折叠、自定义标题，与 Obsidian 对齐、浏览器里也渲染。
Markdown 里怎么写数学公式？ 用美元符号包 LaTeX：单个行内、两个块级，KaTeX 渲染；含 $5 货币防误判的严格边界规则。
Markdown 脚注怎么加？ [^1] 引用 + [^1]: 定义两部分、标签可用词、为什么会显示成原始文本，以及可点击跳转的渲染。
Markdown 怎么加注释？ 用 HTML 注释写不渲染的备注、多行、[//]: # 技巧，以及"不是真隐藏"的坑。
Markdown 删除线怎么写？ ~~文字~~ 划掉文字、为什么有时失效（GFM）、组合粗体与任务清单。
Markdown 粗体不生效？ 看到 ** 而不是加粗——纯文本视图、有空格、或那 app 不渲染；怎么确认你语法对。
Markdown 不渲染？常见的坑 诊断枢纽：整个是原始符号=渲染器问题，只有一处不对=语法坑；每个症状对应修法。
AI 为什么用 markdown？ ChatGPT、Claude 回答里那些 # * - 符号有什么用，一张速查表看懂。
打开 · 把 .md 看明白
md 文件怎么打开？ .md 是什么、用什么打开、怎么看到排版后的样子。
没管理员/装不了 Obsidian 怎么用 vault？ 锁定的公司/学校机上，用已装的 Chrome 免安装打开 vault 里的 .md 笔记；兼容 frontmatter/wikilink，但非完整 Obsidian。
Chromebook 上怎么用 Obsidian vault？ 免 Linux 容器/免安卓 app，直接用 Chrome 打开 vault 里的 .md 笔记；PWA 离线可用，但非完整 Obsidian。
Obsidian 库换别的软件打开会怎样？ 中性对比 6 款：双链、嵌入、块引用、callout 在 NoteLoom / Logseq / VS Code / Typora / 纯文本编辑器里分别变成什么样，以及库里哪些文件根本带不走。
不装 Obsidian 怎么打开 vault？ vault 就是 .md 文件夹；纯文本编辑器只给你裸 [[ ]] 符号，NoteLoom 在浏览器里渲染 wikilink/embed 并写回同一份。
有没有 Obsidian 网页版？ 没有可编辑的官方网页版（Publish 只发只读站）；但 vault 是 .md，能在浏览器里读写这些笔记——非 Obsidian、非完整替代。
Obsidian 笔记就是 Markdown 吗？ 大体是：纯 .md 文本、非专有格式、不锁定；但 Obsidian 加了非标准的 [[wikilink]]/![[embed]] 等（仍是文本）。可移植性拆解。
换 app 编 Obsidian md 会损坏吗？ 怕别的编辑器保存后损坏 frontmatter/callout/wikilink？看往返能保住什么、源码模式直编原文，以及诚实边界。
Obsidian 冲突副本怎么处理？ sync 留下多个 (conflicted copy).md、怕删错？挂 vault、逐个打开读原文和副本、手动挑行合并；NoteLoom 不 auto-merge、也不是同步工具。
怎么把 Obsidian 笔记分享给不装的人？ 不想为几篇笔记买 Publish、搭 Quartz？笔记就是 .md，直接发文件、对方在浏览器里挂文件夹渲染着读（含 callout/图）；不是托管/分享链接服务。
ChatGPT 给的 Markdown 怎么打开？ AI 回答下载成 .md 之后，怎么保存和正常阅读。
ChatGPT Deep Research 报告（.md）怎么打开？ 长报告存成 .md 后表格/引用/公式在纯编辑器里全乱？浏览器里阅读视图本地渲染 GFM 表格+脚注+KaTeX，全程不上传。
Gemini 的答案怎么存成 .md？（无代码） 不用 console 脚本、不碰开发者工具：自己复制存成 .md，再用浏览器渲染着读。NoteLoom 从你存好的那个文件接手。
.md 文件打开安全吗？ markdown 会不会有病毒——纯文本不执行代码；两个真实小风险，以及怎么安全本地查看。
哪些浏览器编辑器能直接开本地 .md 文件夹？ 中性对比：真能挂本地文件夹、就地改 .md 的浏览器工具就那么几个；顺带说清那些常被推荐、其实不是一回事的。
AI · 留住 AI 回答的格式
AI 生成的 PRD 怎么编辑？ ChatGPT、Claude 给的 PRD 是个 .md 文件，怎么读懂结构、改需求、存回本地。
AI 回答怎么保留格式？ 复制 Markdown 后排版不乱掉的保存方法。
使用 · 记笔记与整理
用 Markdown 记笔记怎么开始？ 选一个本地文件夹、定一套简单结构，把 md 笔记真正记起来。
md 文件怎么整理？ 笔记攒多了，怎么把散落的 .md 收拾清楚、好找。
Markdown 转 PDF 工具，谁不上传谁会乱码？ 中性对比 9 个办法：转换到底在浏览器里还是服务器上、中文会不会变方框、公式和图表保不保得住，以及怎么自己验一句「文件不上传」。
扩展 · 把看的和听的存成笔记
网页怎么保存成 Markdown？ 网页剪藏成干净的 .md：先用阅读视图确认正文，再一键转 Markdown、存进你自己的本地文件夹。
YouTube 字幕怎么存成 Markdown？ 字幕自动抽进阅读视图、分好段带时间戳，点剪藏一键转 .md，全程不用手动复制。
B 站字幕怎么存成 Markdown？ B 站的 AI 字幕自动抽出、按章节分段，一键剪藏成本地 .md；没有 AI 字幕轨的视频抽不出来。
进阶 · 开发场景
Codex plan.md 怎么读？ AI 编程工具生成的 plan.md，怎么打开和读懂。
README.md 是什么？ 项目根目录那个「先读我」文件，怎么打开和看懂。
CONTRIBUTING.md 是什么？ 告诉你怎么给项目做贡献的仓库文件：搭建、测试、PR 约定，和 README 的区别。
GEMINI.md 是什么？ Gemini CLI 的规则文件：技术栈/约定/命令，怎么分层加载，和 AGENTS.md 的关系。
.clinerules 是什么？ Cline 的项目规则：.clinerules 文件或 .clinerules/ 文件夹（装 .md），写什么、放哪。
.windsurfrules 是什么？ Windsurf 的规则文件：.windsurfrules 或 .windsurf/rules/ 文件夹（装 .md），写什么、放哪。
AGENTS.md / CLAUDE.md 是什么？ 写给 AI 编程工具看的「常驻规则」文件，怎么读、怎么写。
AI 编程规则文件怎么管理？ 许多 AGENTS.md、CLAUDE.md、.cursorrules 怎么放、怎么整理、怎么确认 AI 读到了。
copilot-instructions.md 是什么？ GitHub Copilot 的项目规则文件放哪、写什么、怎么写。
我的 AI 工具读哪个规则文件？ AGENTS.md / CLAUDE.md / .cursorrules / copilot-instructions 对照：哪个工具读哪个、各自放哪。
AI 写的 plan 太长读不下去？ 长 plan.md 怎么真的读完：渲染了读、先扫标题、直奔风险处。
Claude Code 与 Cursor plan 怎么审？ AI 写了一堆 plan.md 怎么审阅：免安装、不挤 IDE，网页挂载本地项目审阅工作流。
.cursorrules 文件是什么？ Cursor 的规则文件：.cursorrules 与新的 .cursor/rules/*.mdc、.mdc 是什么、放哪。
想跳过教程直接动手？打开网页版 Markdown 编辑器——在浏览器里就能读写本地 .md，免装、免注册；更看重文件留在本地、不上云的，看本地 Markdown 编辑器。
在浏览器中即刻打开本地 .md 文件夹
无需下载安装包，也无需注册账号。用 Chrome / Edge 打开 NoteLoom，挂载你的本地笔记、AI 计划或规约目录，即刻按排版阅读与就地编辑自己的 .md 文件，更有可选的内置 AI 辅助审阅，文件始终保留在本地磁盘上。