Markdown语法介绍

前言

为什么要写博客

  • 先谈论一个话外题,为什么选择写博客,我认为写博客也是一种进步,可以温故,而在你复习的时候又会查阅一些资料,可以知新。

为什么选择Markdown

  • 维基百科介绍:Markdown是一种轻量级标记语言,它允许人们“使用易读易写的纯文本格式编写文档,然后转换有效的XHTML或者HTML文档”,这种语言吸收了很多电子邮件中已有的纯文本标记的特性。
  • 它的优点可以概括为 ”轻量”,“易读易写”,“兼容性强”。

Markdown语法介绍

  • 刚开始写博客,好多东西不太清楚,还望大家谅解,如果有不正确的地方还请大家不要嫌弃,欢迎指出问题,这篇文章适合新手阅读,我也是刚开始学习Markdown语法,希望之后可以互相交流。

编写软件: Atom

基本技巧

  • 重点提示:在命令之后必须有空格,否则不识别你的命令

标题

  • 在markdown中#的个数代表几级标题。

举例

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

编辑器中显示如下图

引用

普通引用 >

举例:
> 划水划水划水水

显示为:
划水划水划水水

代码高亮

  1. 高亮某个函数名或关键字,可以使用函数`print `实现

输入`print`

`print`
  1. 高亮某个代码片段,可以用```包裹代码,并指定一种语言

输入
```java
print(“hello,world”);
```

print("hello,world");
  1. 使用4空格缩进高亮代码,效果类似于方法 2

我发现自己是4个Tab或者8个空格才搞定。
print(“hello,world”);

print("hello,world");

编辑器显示如下

粗体斜体

Markdown 的粗体和斜体使用简单的命令就可以搞定,
1 使用两个**包含文本就是粗体
2 使用一个*包含文本就是斜体
3 使用***包含文本就是粗体加斜体

输入:
ST0new ST0new
若问使君才与术何如?占得人间一味愚。

输出  
*ST0new* **ST0new** ***ST0new***  
*若问使君才与术*,**何如?**?***占得人间一味愚***。

编辑器显示如下

链接

常用链接方法
1 文字连接 [链接名称](https://链接网址)

举例
输入:ST0new的博客

>显示为:[ST0new的博客](https://ST0new.github.io)  

2 网址链接 <http://链接地址>

举例
输入:<https://ST0new.github.io>

显示为
https://ST0new.github.io
编辑器显示如下

图片

插入图片![](图片链接地址)

将图片放在链接后面 由于两者比较相似,具有对比性

举例 放一张我们学校的美图
输入:![](https://i-blog.csdnimg.cn/blog_migrate/4f02a673e015b97df18e262510502302.jpeg)

显示为:

这里提示一下,图片可以是网络中的,或者是本地的,本地可以引用绝对地址和相对地址,但是都不比较保险,图片的位置变动会导致图片失效,建议大家设置图床更加保险。

列表

普通无序列表 * + -三种格式都可以

举例:
- 样式一
+ 样式二
* 样式三
  • 样式一
  • 样式二
  • 样式三

普通有序列表 用数字表示

举例:
1. 样式一
2. 样式二
7. 样式三 #这里写一个错误的数字,仔细观察显示

显示为

  1. 样式1
  2. 样式2
  3. 样式三

这里提示 这里有两个贴心的帮助。
1 它会自动为你添加数字
2 它会帮你修改错误的数字

列表嵌套

1 列表的多段换行需要四个空格
2 列表里的引用也需要加四个空格,在>
3 列表里的代码段也是要加四个空格在按照代码语法

举例:
1. A
    - B
        1. C
        - 前面加四个空格
2. 多段换行
    - 加四个空格
3. 列表的引用
    四个空格
    >前面空一行,在>之后需要四个空格
4. 列表里的代码段

    ```语言
    前面四个空格
    ``````

换行

如果想要另起一行,只需要在结尾加两个空格

举例:
我想换行[空格][空格]
我不想换行了

> 显示为:我想换行  
我不想换行了

分隔符

如果你想有分割线,那么新起一行输入三个减号---

举例:
哈哈哈
---
分割线下

哈哈哈

分割线下

表格

表格定义为 | xx | xx | xx |

举例:
|  编号  |  姓名  |  技能  |    评分  |
|:--------:|-------  |----------|---:|
|  001  |  张三   |  写作  |  93   |
|  002  |  李四   |  学习  |  97   |
|  003  |  王五   |  社交  |  96   |
|  004  | ST0new|  篮球  |  90   |

这里注意在列和字段之间有还有一个|—|---|—|
:的使用,只有左边为左对齐,只有右边为右对齐,两边都有为居中

编号姓名技能评分
001张三写作93
002李四学习97
003王五社交96
004ST0new篮球90

结语:

  • 想要熟悉Markdown的语法还需要多加练习,希望这篇文章可以帮到你

个人博客

ST0new‘blog

参考文献

献给写作者的 Markdown 新手指南
Markdown 编辑器语法指南

<think>我们被要求提供一份详细的、完整的Markdown语法介绍,并以Markdown格式呈现。同时,我们需要参考之前提供的引用内容(引用1-4)来构建答案,但也要确保内容的完整性和系统性。 根据引用内容,我们知道Markdown是一种轻量级标记语言,具有简洁、高效、易读易写的特点,被广泛用于各种平台。我们将按照以下结构组织内容: 1. 基础概念(介绍Markdown是什么,核心优势) 2. 基本语法(包括标题、段落、强调、列表、链接、图片、代码等) 3. 扩展语法(表格、任务列表、删除线等) 4. 其他注意事项(兼容HTML、特殊字符处理等) 同时,我们将遵循用户给出的系统级指令: - 行内数学表达式用$...$,独立公式用$$...$$ - 使用中文 - 生成相关问题 - 在引用处添加引用标识(如[^1]) 由于用户要求详细且完整,我们将尽可能覆盖常用的Markdown语法,并给出示例。 注意:用户提供的引用中,引用[1]介绍Markdown的基本概念和优势,引用[2]提到了Markdown的直观性,引用[3]补充了基础概念和核心优势,引用[4]详细说明了链接的语法。 下面开始编写详细的Markdown语法介绍。 </think> # Markdown 语法完整指南 > Markdown 是一种**轻量级标记语言**,使用简单易读的纯文本格式编写文档,可转换为结构化的 HTML/PDF 等格式。其核心优势在于语法简洁直观,无需复杂排版工具,让作者专注于内容而非格式[^3]。 ## 一、基础语法 ### 1. 标题 ```markdown # 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题 ``` ### 2. 段落与换行 - 段落:空行分隔文本块 - 换行:行末添加**两个空格**或使用`<br>` ### 3. 文本样式 ```markdown *斜体文本* 或 _斜体文本_ **粗体文本** 或 __粗体文本__ ***粗斜体文本*** 或 ___粗斜体文本__ ~~删除线文本~~ ``` ### 4. 列表 **无序列表**: ```markdown - 项目1 - 项目2 - 子项目(缩进2空格) * 替代符号 ``` **有序列表**: ```markdown 1. 第一项 2. 第二项 1. 子项(缩进3空格) ``` ### 5. 链接 ```markdown [链接文本](URL "可选标题") [参考式链接][id] [id]: https://example.com "标题" 自动链接:<https://example.com> ``` ### 6. 图片 ```markdown ![替代文本](图片URL "标题") ``` ### 7. 代码 行内代码:`print("Hello World")` 代码块: ````markdown ```python def hello(): print("Hello, Markdown!") ``` ```` ## 二、高级语法 ### 1. 表格 ```markdown | 左对齐 | 居中对齐 | 右对齐 | |:-------|:--------:|-------:| | 单元格 | 单元格 | 单元格 | | **粗体** | `代码` | [链接](url) | ``` ### 2. 引用块 ```markdown > 一级引用 >> 嵌套引用 ``` ### 3. 分割线 ```markdown --- *** ``` ### 4. 任务列表 ```markdown - [x] 已完成任务 - [ ] 未完成任务 ``` ### 5. 数学公式 行内公式:$E=mc^2$ 独立公式: $$ \sum_{i=1}^n i = \frac{n(n+1)}{2} $$ ### 6. 脚注 ```markdown 这是一个带脚注的文本 : 脚注内容 ``` ## 三、特殊技巧 ### 1. HTML混合 ```markdown <p style="color:blue">HTML内容</p> ``` ### 2. 转义字符 ```markdown \* 转义星号 \` 转义反引号 ``` ### 3. 定义列表 ```markdown 术语1 : 定义1 术语2 : 定义2 ``` ## 四、最佳实践 1. **文件扩展名**:`.md` 或 `.markdown` 2. **兼容性**:GitHub Flavored Markdown (GFM) 支持表格、任务列表等扩展 3. **编辑器推荐**: - VS Code + Markdown All in One 扩展 - Typora(所见即所得) - Obsidian(知识管理) > Markdown语法全由一些符号所组成,这些符号经过精挑细选,其作用一目了然。比如:在文字两旁加上星号,看起来就像*强调*。Markdown 的列表看起来就是列表,引用看起来就像引用[^2]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值