NoteLoom 博客
Markdown 教程与指南
把和 Markdown 有关的常见问题写成了一份份教程：怎么打开 .md、Markdown 怎么写、怎么拿它记笔记、文件多了怎么整理，以及 AI 给的 Markdown 怎么保存。
全部都是免装插件、不用注册的做法。需要一个能边写边看、直接读写本地文件夹的编辑器时，可以用浏览器里打开的 NoteLoom。
入门 · 先搞懂 Markdown
Markdown 是什么？ 一句话理解这个格式，以及为什么 AI 经常用它写回答和文档。 Markdown 文件用来干什么？ AI 输出 / README / 笔记 / 编程规则 / 写作——.md 的主要用途，和为什么选它而非 Word。 Markdown 怎么写？ 新手必学的基础语法，加上边写边看排版的方法。 Markdown 表格怎么写？ 表格的写法、左中右对齐、单元格换行与转义，一次讲清。 Markdown 换行不生效？ 按回车不换行的原因，和两个空格 / <br> / 空行三种正确写法。 Markdown 分隔线怎么写？ --- / *** / ___ 画横线，以及为什么 --- 会把上一行变成大标题（Setext 坑）。 Markdown 怎么插入图片？  语法，以及图片不显示（路径写错 / 读不到本地文件）怎么修。 Markdown 图片太大怎么缩？ 标准 md 无尺寸语法：可移植的 HTML <img width>，和 NoteLoom 的 |300 简写 / 拖拽改宽。 Markdown 代码块怎么写？ 行内代码、三反引号围栏块、加语言高亮，以及代码块不渲染怎么修。 Markdown 怎么加链接？ [文字](链接) 语法、相对 / 锚点 / 引用式链接，以及链接失效怎么修。 Markdown 列表怎么写？ 无序 / 有序 / 嵌套 / 任务清单复选框，以及列表不渲染怎么修。 Markdown 转义怎么写？ 用反斜杠让 * # _ 原样显示、别变格式；代码里不用转、下划线变斜体的坑。 Markdown 引用怎么写？ > 语法、多段引用、用 >> 嵌套、引用里放内容，以及断在半路怎么修。 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 怎么打开 vault？ vault 就是 .md 文件夹；纯文本编辑器只给你裸 [[ ]] 符号，NoteLoom 在浏览器里渲染 wikilink/embed 并写回同一份。 ChatGPT 给的 Markdown 怎么打开？ AI 回答下载成 .md 之后，怎么保存和正常阅读。 .md 文件打开安全吗？ markdown 会不会有病毒——纯文本不执行代码；两个真实小风险，以及怎么安全本地查看。AI · 留住 AI 回答的格式
AI 生成的 PRD 怎么编辑？ ChatGPT、Claude 给的 PRD 是个 .md 文件，怎么读懂结构、改需求、存回本地。 AI 回答怎么保留格式？ 复制 Markdown 后排版不乱掉的保存方法。使用 · 记笔记与整理
用 Markdown 记笔记怎么开始？ 选一个本地文件夹、定一套简单结构，把 md 笔记真正记起来。 md 文件怎么整理？ 笔记攒多了，怎么把散落的 .md 收拾清楚、好找。进阶 · 开发场景
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 怎么真的读完：渲染了读、先扫标题、直奔风险处。 .cursorrules 文件是什么？ Cursor 的规则文件：.cursorrules 与新的 .cursor/rules/*.mdc、.mdc 是啥、放哪。想跳过教程直接动手？打开网页版 Markdown 编辑器——在浏览器里就能读写本地 .md，免装、免注册；更看重文件留在本地、不上云的，看本地 Markdown 编辑器。
直接动手写一篇
打开 NoteLoom，选一个本地文件夹，就能在浏览器里读写自己的 .md 文件——不用装软件，也不用注册账号。