有人说markdown难，有人觉得markdown就是记笔记时偶尔用一下的语法，还有人打开语法手册看两行就关掉了。但实际上，大部分人对markdown的误解来源于没见过一张真正有用的速查图，也没人告诉他"你只需要记住这些，剩下的边用边查"。这篇内容就是把markdown最核心、最高频的语法标签一次性讲清楚，并且把那些在手册里写得云里雾里的细节——比如换行、图片路径、表格、数学公式、工具链——全部摊开揉碎，放到真实的使用场景里去解释。
这篇文章适合谁看？想用markdown做笔记、写技术文档、搭个人博客、做知识管理的人，还有那些在vscode、typora、obsidian里写了半天却总在语法上卡壳的新手。我先说结论：markdown完整规范有一百多处细节，但你在实际写作里用到的不会超过20个标签。把这20个记住，就已经超过市面上90%的日常使用者了。下面直接进入正题。
1. 为什么markdown值得花半小时学会
1.1 markdown解决的是"写作被格式打断"的问题
先聊一个最根本的问题：我们过去写文档用Word，写完标题要选中文字、改字号、加粗、调行距，一套操作下来，思路早就断了。markdown的逻辑完全不同，它把格式符号直接混在文字里，你写# 标题就是一级标题，写**加粗**就是加粗，写完了不用拿鼠标反复去点工具栏，手指不离开键盘，思路不断。
这个区别往深了说，是"所见即所得"和"所见即所写"两个流派的分歧。Word是前者，markdown是后者。但markdown的聪明之处在于，它能在你写完的瞬间通过预览窗口渲染成带格式的样子，等于鱼和熊掌兼得了。所以现在程序员写README、写技术文档，产品经理写PRD，博主写公众号草稿，都在往markdown上迁。
1.2 一次编写、到处渲染，才是markdown最大的隐藏价值
markdown文件本质是纯文本，这就带来一个杀手级特性：它不受任何软件绑架。你用typora写的.md文件，拿到vscode能开，扔到obsidian能开，传到GitHub能自动渲染成网页，发到掘金、知乎这类社区能直接粘贴发布。甚至同一个文件既能在手机上编辑，又能交给脚本批量处理。
这背后的原理很简单：markdown是"源文件"，不同的平台只是"渲染器"。源文件永远忠实保留你的内容，渲染器负责把它变成漂亮的样式。这意味着你的笔记资产被彻底解放了——不会出现十年前用某国产笔记软件、后来软件停止维护、导出还要收费的惨剧。这个优势，用markdown越久感受越深。
1.3 半小时能学会、一辈子都在用，投入产出比极高
做个不严谨的估算：花30分钟掌握核心语法标签，之后每次写文档都能省下至少20%的排版时间。如果一年写100篇文档，这半小时的投入能换来几十个小时的节省。而且更重要的是，markdown的语法设计基本遵循"所见即所猜"——你看到一个#就知道是标题，看到*就知道是强调，不需要死记硬背。
真正劝退新手的往往不是语法本身，而是搜索到的资料质量参差不齐。有的手册列出了所有规范，把不常用的交叉引用、脚注、定义列表全部摆上来，看起来吓人；有的教程又太简略，换行都不讲。所以接下来这一节，我直接把最有用的一整套语法标签整理成速查表，顺便把表里每一行都拆开讲透。
2. 一图速查：markdown核心语法标签全表
2.1 先看一张可以保存到本地的速查图
这一节就是标题里说的"一图秒懂"。下面的图不是截图，而是用markdown本身画出来的一份速查表，你把它复制到任意markdown编辑器里就能秒懂。这也是markdown很妙的地方——它连自己都能作为内容被渲染成表格。
# 一图秒懂markdown语法标签 | 功能 | 语法写法 | 渲染效果 | | ------------ | ------------------------------- | ------------------------------ | | 一级标题 | # 标题 | 标题（最大） | | 二级标题 | ## 标题 | 标题（次大） | | 三级标题 | ### 标题 | 标题（中等） | | 加粗 | **加粗文字** | 加粗文字 | | 斜体 | * 斜体文字 * 或 _斜体文字_ | 斜体文字 | | 删除线 | ~~删除线~~ | 删除线 | | 行内代码 | `code` | code（有底色） | | 代码块 | ```语言名 ... ``` | 带语言高亮的整块代码 | | 无序列表 | - 项目 或 * 项目 | 项目符号列表 | | 有序列表 | 1. 项目 2. 项目 | 数字序号列表 | | 任务列表 | - [ ] 未完成 - [x] 已完成 | checkbox | | 引用 | > 引用文字 | 左侧竖线引用的块级内容 | | 链接 | [文字](https://地址) | 可点击的文字链接 | | 图片 |  | 图片 | | 分隔线 | --- | 横线分隔 | | 表格 | 用竖线、短横线、冒号组装 | 渲染成规整的表格 | | 换行 | 行尾加两个空格再回车 | 变成一个新的行而不是新段落 | | 数学公式 | $行内公式$ 或 $$块级公式$$ | 渲染为数学公式 | | 折叠块 | <details> <summary>标题</summary> | 可展开折叠的容器（部分编辑器支持） |提示：把这份表存成md文件放进自己的笔记库里，遇到语法想不起来的时候，打开它比翻搜索引擎快得多——我就是这么干的，比收藏几百篇教程实用。
2.2 标题、段落与换行：最容易栽跟头的地方
标题语法没啥好说的，#到######分别对应一级到六级标题。需要注意的有两点：一是#后面必须有空格，写成#标题在大多数渲染器里都不会生效，只会显示成纯文本的"#标题"；二是很多编辑器里，同级标题会入自动大纲，这让你不用装额外的目录插件就能实现文档内部导航。
段落是markdown里默认的文本组织方式，连续多行不带空格的文字会被合并成一个段落。真正的坑在换行：如果你想在一个段落内部强行换行，直接按回车是没用的，渲染出来还是同一行。必须要在行尾加两个空格再回车，才会真正换行。我知道这个设定很反直觉，但它源于markdown最初的邮件文本设计——因为那个年代没有所见即所得，两个空格就是"硬回车"的标记。
如果你觉得每次敲两个空格太反人类，有两条出路：一是用typora这类编辑器，它默认的"回车即换行"模式和Word一致；二是在vscode里装一个markdown all in one插件，配合设置项也能极大缓解换行问题。但你要明白，规范就是规范，把两个空格记成"软换行符"，以后在任何编辑器里都不会迷惑。
2.3 强调、删除线、分隔线和特殊符号的转义
加粗、斜体和删除线这组"文字修饰"标签，逻辑特别直白：**两个星号**表加粗，*一个星号*表斜体，~~两个波浪线~~表删除线。而且它们可以嵌套组合，比如***加粗斜体***就是又粗又斜，这在写文章重点句时特别常用。
分隔线是三个短横线---，但这里有个很大的坑：如果你在表格下面用了---，它可能会被解读为表格的格式定义行，而不是分隔线。另外，有些编辑器里，单独一个空行后紧跟---，默认会帮你新建一个二级标题（匹配了##标题语法的缩写）。还有一点，分隔线上下要留空行，否则它紧贴段落会非常难看。
特殊符号的转义要在前面加反斜杠\。比如你想原样输出#号，就得写成\#，否则渲染器会认为你是要建标题。同理，*、_、`、[]、{}这些有特殊语法含义的字符，在不想让它触发格式的时候，全都用反斜杠来转义。这个逻辑和大多数编程语言一样，理解一次就能举一反三。
2.4 列表：无序、有序和任务清单的三重写法
无序列表用-、*、+都可以，统一用一种就行。注意符号后面要跟一个空格再写字，而且列表项之间最好保持同样的缩进层级——一个Tab或两个空格缩进就代表嵌套子列表。我见过很多新手把多层列表写得乱七八糟，渲染出来层级混乱，就是因为缩进不一致。
有序列表更简单，写1.、2.、3.就行。但有个专业技巧你可能不知道：有序列表前面的数字不一定要按顺序，渲染器会自动按序号显示。也就是说你全部写1.，最终也会渲染成1、2、3、4……这样在增删列表项时，就不用手动重新编号了，这个特性在维护文档时能省不少事。
任务清单（task list）是markdown对效率工具的绝妙补充，语法是- [ ] 未完成和- [x] 已完成。中括号里是空格就是未勾选，是x就是已勾选。在GitHub、vscode、obsidian里，这些清单可以直接点击勾选。做个人任务管理、写作大纲都能用它，比如我在写长文时就把大纲列成任务清单，写一小节勾一小节，非常有成就感。
2.5 代码块与行内代码：技术写作的命根子
写技术文章的人，最在意的就是对代码的支持。行内代码用单个反引号包裹，适合在句子中夹一个函数名、命令或变量，比如`print()`。代码块用三个反引号，并在开头写上语言名，比如```python，渲染器就会自动做语法高亮。
关于代码块有几个细节值得记住：第一，代码块内部的文字不会被渲染，你写**加粗**它也原样显示成**加粗**，这是写教程最需要的安全特性；第二，语言名写错不会报错，只是没有高亮，常见的有js、python、java、bash、json、html、css；第三，如果你要在代码块里再嵌套一个代码块，可以用四个反引号做外层包裹，这个嵌套技巧90%的人不知道。
2.6 链接、图片和引用：让文章"活"起来的元素
链接的语法是[显示文字](目标地址)，目标地址可以是https开头的网络URL，也可以是相对路径的本地文件，比如[上一篇](./last-article.md)。这个相对路径特性在本地笔记库里非常方便——你在obsidian里用[[笔记名]]双链那是软件特性，但跨软件通用的写法还是标准链接语法。
图片的语法是，和链接只差一个英文感叹号。替代文字在图片加载失败时会显示，在正常渲染时鼠标悬停也会看到。图片地址同样支持网络URL和本地相对路径。后面我会专门讲图片路径这个高频大坑，这里先记住基本语法。
引用是用>写在段落开头，可以是单行引用，也可以连续多行引用组成长篇。>后面加一个空格、再接内容，是常用的标准写法。引用可以嵌套，>>就是引用里的引用。写文章时引用别人观点、摘录文档，或者自己给自己加注释（类似于博客的备注块），全靠这个标签。
3. 高频语法背后的隐藏细节与避坑指南
3.1 图片路径的三种写法，以及为什么你的图总是裂掉
图片语法看着简单，但实际操作时很多人立刻栽在路径上。写网络图片时，地址必须是完整的URL，包括https://协议头，否则渲染器可能把它当作相对路径去本地寻找。写本地图片时，有相对路径和绝对路径两种；相对路径是相对于当前md文件所在目录的路径，绝对路径是相对于整个电脑根目录的完整路径。
我强烈建议你在写作时统一使用相对路径。比如笔记库目录结构是docs/笔记.md，图片放在docs/images/图.png，那么在笔记里的引用就该写成。这样做的好处是：整个文件夹一起移动到别的电脑、推送到GitHub、上传到博客，图片都不会丢。因为相对关系没有变。
在typora里有个特别贴心的设置：偏好设置里可以选择"复制图片到指定目录"，并设置是否自动更新引用路径。这个习惯我从开始用markdown起就建立了：任何需要插入的图片，一律先拷到笔记同级的images目录下，再用相对路径引用。这比你随便在电脑里放个绝对路径稳妥一万倍。
另一个高频问题：在vscode里markdown预览时图片能显示，但推到GitHub就不显示了。大部分原因是路径包含了反斜杠\（Windows习惯）或者文件名有大写/空格。规范的写法是统一用正斜杠/，文件名避免空格和中文（或转成URL编码）。这个细节说小很小，但排查时极其费时间。
3.2 表格语法：常用列对齐，以及为什么复制到Excel乱了
markdown表格的写法是用竖线|分隔列，第二行用短横线-区分表头和内容区。比如：
| 姓名 | 年龄 | 城市 | | ---- | ---- | ---- | | 张三 | 25 | 北京 | | 李四 | 30 | 上海 |渲染后就是一张规整表格。第二行里冒号的位置控制对齐方式：默认是左对齐，:---是左对齐，---:是右对齐，:---:是居中对齐。这个细节在表格数字列对比时特别有用，右对齐会让数字的个位对齐，看着舒服多了。
表格语法本身不难，但最让人头大的是复制粘贴。从markdown表格直接复制到Excel，默认不会拆成行列，全部挤进一个单元格。解决方案有几个：一是用在线转换工具，把markdown表格转成csv再导入Excel；二是直接用pandoc，pandoc input.md -o output.xlsx能直接把文档转成Excel格式；三是很多markdown编辑器支持复制为指定格式。我更推荐第二个方案，因为pandoc是跨平台开源工具，能处理复杂表格。
3.3 数学公式：LaTeX语法在markdown里的正确写法
数学公式是另一大高频需求。markdown语法中有两套数学公式写法：整行公式。行内公式用单个美元符号包围，比如$E=mc^2$，渲染后公式嵌在文字里；块级公式用双美元符号包围，比如$$\int_0^1 x^2 dx$$，渲染后公式独占一行且居中。
公式的内部语法遵循LaTeX，功能很大，但基础需求只需要记住几个符号：上标^，下标_，分号\frac{分子}{分母}，希腊字母\alpha、\beta、\theta，求和\sum，积分\int，根号\sqrt{}。这些符号组合起来能覆盖从中学到大学的绝大多数公式。
需要注意，并不是所有markdown编辑器都原生支持数学公式渲染。typora内设了MathJax引擎，开箱即用；vscode则需要安装markdown+math插件或使用带数学支持的预览扩展；obsidian默认也支持。如果你在一个不支持的编辑器里写$公式$，它只会被当成普通美元符号显示，不会报错，但也不会渲染。
3.4 折叠块和分级细节：高级但不复杂的加分项
折叠块（collapsible block）不属于最基础的那20个语法标签，但在需要"收起长代码、默认展示结论"的场景下极其好用。语法是HTML标签：
<details> <summary>点击展开查看详情</summary> 这里写被折叠的内容，支持markdown语法。 </details>预览时只会看到可点击的"点击展开查看详情"，点击后才显示内容。这在GitHub的issue回复里很常见，在个人笔记里做"答案先藏在折叠里，自己回忆一遍再打开"也很有趣。obsidian和typora对折叠块支持不错，vscode需要配合预览插件。若你主要在某个编辑器里写作，建议先测试兼容性再大规模使用。
除了折叠块，还有一个常被忽略的细节：markdown标签前后的空行。我的经验是：绝大多数语法元素（标题、列表、代码块、引用、表格）前后都留一个空行，既能保证在各种渲染器里表现一致，也让源码读起来更清爽。有人喜欢把所有内容挤在一起，这在typora里也许没事，换到GitHub上就会排版错乱。
4. 编辑器与插件工作流：选对工具，体验翻倍
4.1 新手先选一个"所见即所得"的编辑器
markdown语法是通用的，但编辑器的使用体验千差万别。我给新手的建议是：第一优先级选typora。它是最早把markdown做成"所见即所得"的桌面级工具之一，左边写右边实时渲染，图片拖拽即可插入，还自动帮你补全相对路径，对几乎没有技术背景的人极其友好。
另一类流派是"源码+分屏预览"，代表是vscode。它本体是代码编辑器，但对markdown支持极强，更重要的是插件生态无敌，写md的同时还能顺手写代码、跑脚本、管理版本。我用vscode写技术博客已经好几年了，不管是本地预览还是发布前的格式检查都相当顺手。
obsidian则适合长周期的知识管理。它基于本地markdown文件，支持双链、图谱、插件市场，特别适合搭个人知识库。它的渲染风格偏简洁，而且所有笔记都是md文件，将来换工具零负担。如果你正处于"想长期积累知识、又担心笔记软件绑架你"的状态，我建议直接上车obsidian。
4.2 vscode里值得装的markdown插件清单
vscode本身对markdown只能算"能渲染"，真正的体验靠插件。我最常用的几款：
- Markdown All in One：自动生成目录、快速切换加粗斜体、自动格式化表格、快捷键补全，新手装它就够了。
- Markdown Preview Enhanced：增强预览功能，支持数学公式、导出PDF/HTML、自定义CSS，还能绘制高级图表，预览快捷键是
Ctrl+K V（分屏预览）和Ctrl+Shift+V（独立预览）。 - markdownlint：帮你检查语法不规范的地方——比如标题前后空行缺失、列表符号不一致、代码块语言未指定，它都会用黄色波浪线提示，对养成好习惯帮助极大。
装完插件记得改两个地方：第一个是文件关联，把.md文件默认关联到markdown语言模式（一般装完插件就会自动关联）；第二个是预览窗口的样式，如果你觉得默认预览字号太小，可以自己写一份CSS覆盖。这些配置都散落在settings.json里，自己稍微调试一下，就能让vscode的markdown体验不输给typora。
4.3 markdown转PDF、Word、HTML的实用工作流
写作完的markdown文件，最终总要交付出去。最常见的导出需求是PDF和Word。最优雅的方案就是pandoc——堪称"文档转换界的瑞士军刀"。
把md转Word：
pandoc input.md -o output.docx把md转PDF（需要LaTeX环境，记得先装好）：
pandoc input.md -o output.pdf --pdf-engine=xelatex把md转HTML：
pandoc input.md -o output.html -s --metadata title="文章标题"vscode里安装了Markdown Preview Enhanced之后，也可以直接在预览窗口右键选择"Export to PDF"，不需要装额外的LaTeX环境就能导出。另一个轻量选择是typora，它的"导出->PDF"做得也很顺滑，直接打开文件菜单导出即可。
如果你有经常性"md转Word并保持格式完整"的需求，还可以在coze或一些自动化平台里搭一个工作流：上传md文件，调用转换节点，直接输出Word。这类需求本质就是"把pandoc封装成服务"，适合团队内部共享。个人用的话，本地装pandoc一劳永逸。
4.4 网页内容怎么一键变成规范markdown
平时在网上看到好文章，总想保存成markdown放进自己的笔记库。最实用的方案是浏览器插件markdownload，安装后在网页上右键就能把当前页面正文提取为markdown，还支持自定义提取规则、保持图片链接。虽然说提取质量不能保证100%完美，但对大部分博客和文档网站效果已经相当不错。
另一个思路是用在线转换工具：直接把网页内容粘贴进去，它自动抽取正文并转成markdown。这类工具多如牛毛，我建议你在收藏夹里存两个备用就行。需要特别提醒的是：不管用什么方式从网页转markdown，转换完成后一定要人眼检查一遍图片链接、标题层级和代码块是否完整，我曾经遇到过转换结果里把代码块的三个反引号吞掉的情况，导致整篇文章格式崩掉。
如果你追求更自动化，还可以用jupyter notebook场景里常见的方案：把网页先保存成html，再用pandoc做html -> md的转换，一些已经不支持在线更新的老旧网页内容，这个方法往往比在线插件更可靠。
5. 编辑器之间的兼容性与选型深入对比
5.1 同样是markdown语法，为什么在不同软件里渲染不一样
很多人困惑：同一份md文件，在typora和github上打开，效果怎么不一样？原因很简单——markdown规范在基础语法之外，不同平台会扩展自己的方言。GitHub上有GitHub Flavored Markdown（GFM，GitHub风格扩展），typora和obsidian也各有自己的高亮语法、双链语法等特性。
最经典的分歧就是任务列表：基础markdown规范没有定义- [ ]，GitHub支持，typora支持，vscode支持，但某些轻量渲染器会原样显示成- [ ]。所以如果你要写一份能到处跑的markdown，尽量只用GFM覆盖范围内的语法——标题、列表、表格、代码、引用、链接、图片，这些最安全。
5.2 图片与附件的管理方案对比
图片管理其实是markdown笔记体系里最关键的一环。typora的做法是"本地相对路径物理复制"，obsidian则默认把附件统一放入指定附件文件夹，vscode基本上全靠你自己维护目录结构——因为它就是个编辑器，不管你的资源。
我的建议是：不管用哪款，一律把附件放在笔记同级的assets或images目录，并用相对路径引用。如果担心笔记多而杂，可以按"一个大主题建立一个文件夹，里面同时放笔记和素材"，这样既好备份也好同步。
图床则是更进阶的方案：把图片上传到对象存储，远端得到一张图片URL，md文件里直接引URL。适合写博客、发社区的人，因为没有本地资源依赖，任何平台一贴就能显示。但本地笔记因为离线优先考虑，用相对路径更稳。我的习惯是"本地笔记全部相对路径，发布到博客时再统一处理成图床链接"。
5.3 目录、锚点与内部跳转
长文档写作时，目录（TOC）几乎是刚需。在vscode的Markdown All in One里，打开命令面板Ctrl+Shift+P，输入Markdown All in One: Create Table of Contents即可生成目录，并可以跟随标题变化动态更新。typora则是在标题右键直接插入目录，GitHub也会自动为所有标题生成锚点并显示在页面顶端。
内部跳转依赖于标题的锚点规则：在GFM中，标题"## Hello World"对应的锚点约定是#hello-world——全部转小写、空格转短横线、移除标点。所以你在文章里可以用[跳转标题](#hello-world)做站内锚点。这个技巧在一个很长的技术文档、FAQ页面里特别实用。
5.4 从jupyter notebook到obsidian：不同场景的语法选择
jupyter notebook用户经常需要在笔记单元里写说明文字，在其中使用markdown语法是一样的，但有个值得注意的点：jupyter里的markdown渲染默认不支持所有语法，比如与某些复杂表格和HTML标签的兼容性较差。在notebook里，我更推荐用GFM基础子集，特别是标题、列表、代码块、公式，这些是最稳的组合。
obsidian用户则要熟悉它的双链语法[[笔记名]]和#标签，这些在obsidian中极其强大，因为它们是"知识网络连接器"，但是从obsidian导出的md文件，标准的markdown渲染器会原样显示双链文本，不会变成可点击链接。如果你想把obsidian笔记发布到博客，需要先用插件把双链转换成普通的markdown链接。
5.5 用markdown四象限图来理解自己的学习路径
把上述内容放到更宏观的视角来看，可以用一个四象限帮读者定位当前阶段。第一象限是"纯阅读者"：只用markdown做简单备注，事实上连语法都不必背，选个typora就能边看边学；第二象限是"日常写作者"：需要掌握前面那20个标签，用typora或obsidian做笔记、写周报；第三象限是"技术发布者"：需要在vscode里配插件、用pandoc导出、处理图片路径，这是技术博主和文档维护者的日常；第四象限是"高级自动化用户"：要求不仅能写，还能用脚本批量处理md文件、用API调起转换工具，把markdown嵌入到自己的自动化工作流中。
你不需要一开始就追求第四象限。大多数新手的快速通关法则是：先用typora写一周，把语法在真实写作中过两遍，再决定是否迁到vscode或obsidian。语法是通用的，熟练度才是真正要积累的东西。
6. 常见问题排查与实操心得
6.1 换行不生效、预览和想象不一样
排查思路很简单：先把渲染效果打开，对照源码和预览看。如果文字确认为同一段，而你想换行却没换，十有八九是行尾没加两个空格。如果加了两个空格还是不换行，可能是编辑器的"严格模式"关掉了，在设置里搜索trim_trailing_whitespace，把相关的"保存时去除行尾空格"选项关掉就行——这个坑在vscode里非常经典。
6.2 表格渲染变形或直接显示为横线
表格变形通常是因为表头分隔那行的短横线数量太少或不一致。其实短横线数量不影响渲染，但确保至少有两个短横线。更常见的问题是表格前后没有空行，导致上一段正文和表格混在了一起。在markdown里，表格和列表一样是"需要空行保护"的元素，前后各留一个空行基本能杜绝绝大多数格式错乱。
如果你写了表格但预览里只显示一行横线，那大概率是分隔线的写法被解析成了---而不是表格的第二行。打个最简单的排查方法：把表格的每一列之间都用|对齐，第二行用| ---- | ---- |，不要省略两端的竖线。虽然有些渲染器允许省略边缘竖线，但加上是最保险的。
6.3 代码块语言没高亮、公式显示不出来
代码块语言没高亮，先检查语言名是否写在三个反引号同一行且拼写正确。python可以，py不一定所有渲染器都认，尽量用官方语言标识。公式渲染不出来，大概率是编辑器的数学支持被关掉了——在typora的偏好设置、vscode的Markdown Preview Enhanced设置里都有一个math开关，找到它并打开。
6.4 图片显示不出来、路径怎么改都对不上
我的排查顺序是：先看图片文件是不是真的存在那个路径，再检查文件名大小写是否完全一致（很多服务器文件系统是区分大小写的），再看是否使用了绝对路径（临时能用但一搬文件夹就裂）。如果是网络图片，记得检查链接是否完整、域名是否可达。如果本地路径里出现中文或空格，先测试改成英文文件名——我见过太多人卡在这种地方。
6.5 从网上复制的代码或表格粘贴进来就乱
从网页复制的表格粘贴进markdown编辑器，经常变成一行纯文本或一堆竖线。标准解法是：先在富文本场景（比如Word）里粘贴成表格，再用在线转换工具转成markdown表格。代码块乱的解决方式更简单：粘贴前先缩进一个Tab，或者粘贴时选择"粘贴为纯文本"。
还有一个经验值得分享：我们的内容是针对新手进行的基础指导，但不承诺工具和一切外部链接永久可用。在互联网上，工具是流动的，学会了语法，你永远不会失去核心能力。
7. 最后再分享一点我的markdown使用体会
写markdown久了，最大的感受是它把我从"排版焦虑"里解放了出来。以前用Word，我最讨厌的就是贴代码和调整列表缩进，光标点来点去，格式还是乱的。换到markdown后，手只需要在键盘上流动，想加粗就包两个星号，想插入代码就写三反引号，思路完全不用被打断。坚持几个月后，我甚至反过来把写PPT的思维也换成了markdown——先用标题做骨架，再用列表提炼要点，最后才套模板，效率比过去高很多。
如果你刚开始接触markdown，我给你的建议是从typora或obsidian选一个，先把这篇里讲的20个语法标签过一遍，然后去写几篇真实的笔记或文章。不要试图一次背完所有语法，也不用急着折腾各种插件和pandoc，写作本身才是最重要的。遇到语法想不起来，回来翻这篇文章里的速查表就够了。
等你彻底习惯了markdown这种"以纯文本为源、到处可渲染"的思维方式，你大概率会和我一样，再也回不到那个被格式工具栏绑架的写作状态了。
