Markdown 新手教程

Markdown 怎么写?
新手必学的 8 个基础语法

Markdown 就是用一些简单符号给文字加排版:# 标题**加粗**- 列表[文字](链接)

你写的时候是纯文本,用 Markdown 编辑器打开,这些符号就会显示成排版后的标题、加粗和列表。

下面是新手最常用的 8 个语法,加一个边写边看、不怕写错的方法。

先记住一句话:Markdown 是“纯文本 + 符号”

很多人是被 ChatGPT、Claude、Kimi 这些 AI 工具第一次带进 Markdown 的。

AI 的回答里经常带 #**- 这些符号,那不是乱码,而是 Markdown 在标记排版。

你只要学会几个常用符号,就能自己写,也能看懂 AI 给你的内容。

8 个最常用的 Markdown 语法

下面这张表覆盖了日常写作 90% 的需求。

怎么写 它表示什么
# 标题 一级标题,## 是二级标题
**重点** 加粗
*文字* 斜体
- 列表项 无序列表(圆点)
1. 第一步 有序列表(编号)
[文字](https://...) 可点击的链接
`代码` 行内代码
> 引用 引用块

记住一个规律:符号和文字之间一般要留一个空格,比如 # 标题 而不是 #标题

再补 3 个稍微进阶的

如果你会用到表格、待办和代码块,再记这三个:

  1. 代码块:用三个反引号包住多行代码。
  2. 待办清单:- [ ] 没做的- [x] 做完的
  3. 表格:用 | 分隔每一列,第二行用 --- 画分隔线。

这些都属于 GFM(GitHub 风格 Markdown)语法,主流 Markdown 编辑器都支持。

新手最大的难点:写了不知道对不对

学语法不难,难的是写的时候看不到效果。

在记事本里写 Markdown,你只能看到一堆 #*,不确定排版到底对不对。

解决办法是用一个能“边写边看”的在线 Markdown 编辑器:一边写符号,一边直接看到排版后的样子。

用 NoteLoom 边写边看排版

NoteLoom 是一个浏览器即用的 Markdown 编辑器。它不是 AI 工具,也不是云笔记,专门解决本地 .md 文件怎么读、怎么写、怎么存。

它有三种视图,对新手学语法特别有用:

视图 适合做什么
live 边写边看排版效果,最适合练语法
source 只看 Markdown 源码
reading 只读阅读,不怕不小心改到

新手建议用 live 视图:你打一个 # 标题,它会立刻显示成大标题;打 **加粗**,立刻变粗。写错了一眼就能看出来。

写完之后,内容直接保存成你本地文件夹里的 .md 文件,不上传到服务器。

上手 Markdown 的最短路径

如果你想今天就开始写,可以按这个顺序:

  1. 用 Chrome / Edge / Arc 打开 app.noteloom.cc,选择一个本地文件夹。
  2. 新建一个 .md 文件。
  3. 切到 live 视图。
  4. 照着上面那张表,先练 #**- 三个。
  5. 每打一个符号,看看排版有没有变。
  6. 写顺了再加表格、待办和代码块。

练几次你就会发现,Markdown 比 Word 的工具栏更快——手不用离开键盘。

新手容易踩的 4 个坑

1. 符号后面忘了加空格

#标题 很多编辑器不会渲染成标题,要写成 # 标题

列表的 - 和数字 1. 后面同样要留一个空格。

2. 中文输入法打出了全角符号

Markdown 只认半角符号。

如果 #*- 是在中文输入法下打的全角版本,排版就不生效,记得切回英文符号。

3. 以为换行就会分段

在 Markdown 里,想分成两段,中间通常要空一行。

只敲一次回车,很多编辑器会当成同一段。

4. 把 Markdown 当成乱码

看到 #**、三个反引号,不代表文件坏了。

换到能渲染的 Markdown 编辑器里,它们就会变成标题、加粗和代码块。

FAQ

Markdown 难学吗?
不难。日常写作只要记住 # 标题、** 加粗、- 列表、[]() 链接这几个就够用,其它语法用到时再查。比记 Word 的菜单按钮简单。
Markdown 用什么软件写?
记事本就能写,但它只显示源码符号,看不到排版。如果想边写边看效果,用 Markdown 编辑器更合适,比如可以在浏览器里直接打开的 NoteLoom。
写错了符号会怎样?
不会损坏文件。Markdown 是纯文本,写错的符号最多是没渲染成你想要的样子,改对就行。用 live 视图能马上看出哪里写错了。
Markdown 和普通文本有什么区别?
普通文本没有排版,Markdown 用少量符号标记出标题、加粗、列表等结构。它本身还是纯文本文件,任何文本编辑器都能打开,但 Markdown 编辑器能把符号显示成排版后的效果。
手机能写 Markdown 吗?
Markdown 本身在哪都能写,但 NoteLoom 目前主要支持 Chrome、Edge、Arc 这类 Chromium 系桌面浏览器,Firefox、Safari 和手机暂不支持。
写好的 Markdown 文件怎么保存?
存成后缀为 .md 的文件即可,它是通用格式,以后用任何 Markdown 编辑器都能继续打开。NoteLoom 会把内容直接写回你选择的本地文件夹,也支持一键导出。
NoteLoom 有 AI 功能吗?
没有。NoteLoom 当前没有 AI 对话、AI 总结或语义搜索功能。它解决的是 Markdown 怎么写、怎么读、怎么存在本地。

写下你的第一行 Markdown

打开 NoteLoom,选一个本地文件夹,切到 live 视图,照着上面的语法表打几个符号,看排版实时变化。

打开 NoteLoom 试试