Skip to content

Commit df2907a

Browse files
feat: new markdown tutorials
1 parent 2540d88 commit df2907a

1 file changed

Lines changed: 394 additions & 0 deletions

File tree

tutorial/markdown/markdown.md

Lines changed: 394 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,394 @@
1+
# Markdown 零基础入门教程
2+
3+
## 什么是 Markdown?
4+
5+
Markdown 是一种轻量级的标记语言,就像是给纯文本添加格式的"快捷键"。你只需要用一些简单的符号,就能让文字变得有层次、有重点。笔者就是Markdown重度使用用户,这里因为展开一些工作,需要做一下Markdown培训。
6+
7+
- 📝 简单易学,5分钟上手
8+
- ⚡ 写作效率高,不用鼠标点来点去
9+
- 🌐 广泛应用:博客、笔记、文档、GitHub等
10+
- 💻 纯文本格式,任何设备都能打开
11+
12+
------
13+
14+
## 一、标题:文章的骨架
15+
16+
在文字前面加上 `#` 号,就能创建标题。`#` 越多,标题级别越小。
17+
18+
### 写法示例:
19+
20+
```markdown
21+
# 一级标题(最大)
22+
## 二级标题
23+
### 三级标题
24+
#### 四级标题
25+
##### 五级标题
26+
###### 六级标题(最小)
27+
```
28+
29+
### 显示效果:
30+
31+
# 一级标题(最大)
32+
33+
## 二级标题
34+
35+
### 三级标题
36+
37+
#### 四级标题
38+
39+
##### 五级标题
40+
41+
###### 六级标题(最小)
42+
43+
**小贴士:** `#` 号后面要加一个空格哦!
44+
45+
------
46+
47+
## 二、文字样式:让文字有个性
48+
49+
### 2.1 加粗
50+
51+
`**文字**``__文字__` 把文字包起来
52+
53+
```markdown
54+
这是**加粗的文字**
55+
这也是__加粗的文字__
56+
```
57+
58+
显示效果:这是**加粗的文字**,这也是__加粗的文字__
59+
60+
### 2.2 斜体
61+
62+
`*文字*``_文字_` 把文字包起来
63+
64+
```markdown
65+
这是*斜体文字*
66+
这也是_斜体文字_
67+
```
68+
69+
显示效果:这是*斜体文字*,这也是_斜体文字_
70+
71+
### 2.3 加粗+斜体
72+
73+
`***文字***` 把文字包起来
74+
75+
```markdown
76+
这是***加粗又斜体的文字***
77+
```
78+
79+
显示效果:这是***加粗又斜体的文字***
80+
81+
### 2.4 删除线
82+
83+
`~~文字~~` 把文字包起来
84+
85+
```markdown
86+
这是~~要删除的文字~~
87+
原价~~299元~~,现价99元!
88+
```
89+
90+
显示效果:这是~~要删除的文字~~,原价~~299元~~,现价99元!
91+
92+
------
93+
94+
## 三、列表:整理信息的好帮手
95+
96+
### 3.1 无序列表(项目符号)
97+
98+
`-``+``*` 开头,后面加空格
99+
100+
```markdown
101+
- 苹果
102+
- 香蕉
103+
- 橙子
104+
105+
* 学习 Markdown
106+
* 写文档
107+
* 分享笔记
108+
109+
+ 任务一
110+
+ 任务二
111+
+ 任务三
112+
```
113+
114+
显示效果:
115+
116+
- 苹果
117+
- 香蕉
118+
- 橙子
119+
120+
### 3.2 有序列表(数字编号)
121+
122+
`1.``2.``3.` 开头,后面加空格
123+
124+
```markdown
125+
1. 打开电脑
126+
2. 启动编辑器
127+
3. 开始写作
128+
4. 保存文档
129+
```
130+
131+
显示效果:
132+
133+
1. 打开电脑
134+
2. 启动编辑器
135+
3. 开始写作
136+
4. 保存文档
137+
138+
### 3.3 嵌套列表(多层级)
139+
140+
用缩进(Tab 或 2-4个空格)来创建子列表
141+
142+
```markdown
143+
1. 水果
144+
- 苹果
145+
- 香蕉
146+
2. 蔬菜
147+
- 白菜
148+
- 萝卜
149+
- 红萝卜
150+
- 白萝卜
151+
```
152+
153+
显示效果:
154+
155+
1. 水果
156+
- 苹果
157+
- 香蕉
158+
2. 蔬菜
159+
- 白菜
160+
- 萝卜
161+
- 红萝卜
162+
- 白萝卜
163+
164+
------
165+
166+
## 四、链接和图片
167+
168+
### 4.1 链接
169+
170+
格式: `[显示的文字](链接地址)`
171+
172+
```markdown
173+
[百度](https://www.baidu.com)
174+
[访问我的博客](https://myblog.com)
175+
```
176+
177+
显示效果:[百度](https://www.baidu.com/)
178+
179+
### 4.2 图片
180+
181+
格式: `![图片描述](图片地址)`
182+
183+
```markdown
184+
![可爱的猫咪](https://example.com/cat.jpg)
185+
```
186+
187+
**小技巧:** 图片描述会在图片无法显示时出现
188+
189+
------
190+
191+
## 五、引用:引用别人的话
192+
193+
`>` 开头表示引用
194+
195+
```markdown
196+
> 这是一句引用的话
197+
> 可以连续多行
198+
199+
> 鲁迅说过:
200+
> "我没说过这句话。"
201+
```
202+
203+
显示效果:
204+
205+
> 这是一句引用的话 可以连续多行
206+
207+
> 鲁迅说过: "我没说过这句话。"
208+
209+
### 嵌套引用
210+
211+
```markdown
212+
> 第一层引用
213+
>> 第二层引用
214+
>>> 第三层引用
215+
```
216+
217+
显示效果:
218+
219+
> 第一层引用
220+
>
221+
> > 第二层引用
222+
> >
223+
> > > 第三层引用
224+
225+
------
226+
227+
## 六、代码
228+
229+
### 6.1 行内代码
230+
231+
用反引号 ``` 包裹代码
232+
233+
```markdown
234+
使用 `print()` 函数可以输出内容
235+
```
236+
237+
显示效果:使用 `print()` 函数可以输出内容
238+
239+
### 6.2 代码块
240+
241+
用三个反引号 ``` 包裹,可以指定语言
242+
243+
~~~markdown
244+
```python
245+
def hello():
246+
print("Hello, Markdown!")
247+
显示效果:
248+
249+
```python
250+
def hello():
251+
print("Hello, Markdown!")
252+
~~~
253+
254+
------
255+
256+
## 七、分隔线
257+
258+
用三个或更多的 `-``*``_`
259+
260+
```markdown
261+
---
262+
***
263+
___
264+
```
265+
266+
显示效果:
267+
268+
------
269+
270+
## 八、表格
271+
272+
`|``-` 创建表格
273+
274+
```markdown
275+
| 姓名 | 年龄 | 城市 |
276+
| ---- | ---- | ---- |
277+
| 张三 | 25 | 北京 |
278+
| 李四 | 30 | 上海 |
279+
| 王五 | 28 | 广州 |
280+
```
281+
282+
显示效果:
283+
284+
| 姓名 | 年龄 | 城市 |
285+
| ---- | ---- | ---- |
286+
| 张三 | 25 | 北京 |
287+
| 李四 | 30 | 上海 |
288+
| 王五 | 28 | 广州 |
289+
290+
### 对齐方式
291+
292+
```markdown
293+
| 左对齐 | 居中对齐 | 右对齐 |
294+
| :--- | :---: | ---: |
295+
| 文本 | 文本 | 文本 |
296+
```
297+
298+
------
299+
300+
## 九、任务列表
301+
302+
`- [ ]` 表示未完成,`- [x]` 表示已完成
303+
304+
```markdown
305+
- [x] 学习 Markdown 基础语法
306+
- [x] 练习写文档
307+
- [ ] 分享给朋友
308+
- [ ] 建立自己的知识库
309+
```
310+
311+
显示效果:
312+
313+
- [x] 学习 Markdown 基础语法
314+
- [x] 练习写文档
315+
- [ ] 分享给朋友
316+
- [ ] 建立自己的知识库
317+
318+
------
319+
320+
## 十、实战案例:写一篇完整的文档
321+
322+
~~~markdown
323+
# 我的学习笔记
324+
325+
## 今天学习内容
326+
327+
今天学习了 **Markdown** 语法,感觉非常*实用*!
328+
329+
### 重点内容
330+
331+
1. 标题的使用
332+
- 一级到六级标题
333+
- 用于文档结构
334+
2. 文字格式化
335+
- **加粗**:强调重点
336+
- *斜体*:补充说明
337+
3. 列表整理
338+
339+
### 学习资源
340+
341+
- [Markdown 官方教程](https://markdown.com.cn)
342+
- [GitHub Markdown 指南](https://guides.github.com/features/mastering-markdown/)
343+
344+
### 代码示例
345+
346+
```python
347+
print("Hello, Markdown!")
348+
~~~
349+
350+
### 学习进度
351+
352+
- [x] 基础语法
353+
- [x] 实战练习
354+
- [ ] 高级技巧
355+
356+
------
357+
358+
> 坚持每天学习一点,积少成多!
359+
360+
**作者:** 我自己
361+
**日期:** 202412
362+
363+
```
364+
---
365+
366+
## 十一、常用技巧总结
367+
368+
### 换行技巧
369+
370+
- 段落之间空一行
371+
- 行尾加两个空格再回车(强制换行)
372+
- 使用 `<br>` 标签
373+
374+
### 转义字符
375+
376+
如果要显示特殊符号本身,在前面加 `\`
377+
378+
```markdown
379+
\* 这不是斜体
380+
\# 这不是标题
381+
```
382+
383+
### 快捷键记忆
384+
385+
- `#` = 井号 = 标题
386+
- `*` = 星号 = 强调(加粗/斜体)
387+
- `-` = 减号 = 列表
388+
- `>` = 大于号 = 引用
389+
- \``` = 反引号 = 代码
390+
- `[]` = 方括号 = 链接/图片/任务
391+
392+
## 结束
393+
394+
就这么多,快去梭哈一个README!

0 commit comments

Comments
 (0)