Markdown使用教程

什么是Markdown语言

Markdown是一门如同HTML一样的标记语言。它使用一些简单的标记来展现文档的不同格式，例如，本章节的标题我们就是使用这样的格式表示的：

# 什么是Markdown语言

这个展现出来的就是本章的标题。

为什么使用Markdown语言

  • 样式丰富

    使用Markdown语言，可以使文档拥有丰富的展现形式，各种不同的格式，十分适用于博客，文档等使用场景。

  • 简单易学

    通过上一节的例子我们会发现，Markdown语言明显比其他标记语言，如HTML，简单易学。在HTML中写标题样式是这样的：

    <h1>什么是Markdown语言</h1>

    可以很容易的看出比Markdown麻烦很多——Markdown只需要多一个字符就可以展示为标题，而HTML需要9个。

    另外，Markdown也比HTML易学很多。HTML的教程动辄几百页，而Markdown只要一篇简短的教程就能搞定。

  • 版本控制友好

    如果只是因为有丰富的格式样式的话，我们为什么不选择Word呢？这里有两个原因。其中之一就是版本控制友好。(另一个原因是有很多在线编辑平台支持Markdown，但并不支持Word。)

    一般的版本控制系统都是基于文件字符的，而Word使用的是一种特殊的编码格式。因此，当你使用版本控制工具比对Word文件的版本的时候，你其实能够看到的只是一堆乱码。而如果你要去对比Markdown的文档时，则可以看到非常清晰的版本对比信息。

  • 使用广泛

    大多数的博客系统，如简书，wordpress等；和很多技术社区及文档平台，如github，图灵社区等都支持wordpress编辑模式。学会Markdown就可以让我们在这些平台上更容易地编辑出漂亮的文档。

在哪里实战操作

我们学习一个语言最好的方式就是实战。那么我们学习markdown语言要去哪里实战呢？您可以在网上搜索Markdown在线编辑器，一般这种编辑器都是左边写Markdown，右边就时时把样式展现出来的，十分方便。这样您就可以边看教程，边练习了。

语法

换行

Markdown中最基本的语法就是换行。在标准的Markdown中，输入一个回车是起不到换行的效果的：

第一行
第二行

在标准的Markdown中，这样的文本显示出来的是：

第一行 第二行

如果我想换行就必须在每行的末尾加两个空格，或使用两个回车起到换行的效果（两个回车的换行在展示中也会多一行）。

不过，很多平台，如简书，都支持一个回车直接换行。但是为了确保编写的Markdown有最好的兼容性。还是建议使用标准的Markdown语法进行换行。

标题

标题也是个十分常用的语法。Markdown中最多支持六级标题：

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

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

需要注意的是，标准的格式是 井号+空格+标题。有些Markdown编辑器支持井号后边不加空格也可以，但那是不标准的语法。

加粗

加粗语法一般有两种：

这样可以**加粗**。
这样也可以 __加粗__ 。

这样可以加粗。

这样也可以 加粗 。

加粗的两种语法分别是前后加两个星号，或前后加两个下划线。需要注意的是，前后加两个下划线的写法，在标准的Markdown语法中是要前后加空格的。当然依旧有些编辑器可以省略前后的空格。

斜体

斜体语法一般也有两种：

这样可以*斜体*。
这样也可以 _斜体_ 。

这样可以斜体。

这样可以 斜体 。

斜体的两种语法分别是前后加一个星号，或前后加一个下划线。需要注意的是，前后加一个下划线的写法，在标准的Markdown语法中是要前后加空格的。当然依旧有些编辑器可以省略前后的空格。

删除线

如果我们想明确的表达，不要某句话了或不要这么做，我们可以使用删除线：

~~我要删掉这个。~~

我要删掉这个。

删除线的写法就是前后加两个波浪号。

引用

如果我们想引用一段文字我们可以这样：

>黄鸟于飞，
>集于灌木，
>其鸣喈喈。

黄鸟于飞，

集于灌木，

其鸣喈喈。

使用引用，就是在你引用的文字前边加上小于号。

引用代码

引用代码分为两种模式，一种是行内引用，一种是多行引用。

我们先来说行内引用：

使用‘public static void main()‘来声明入口函数。

使用public static void main()来声明入口函数。

我们在要引用的代码前后都加一个撇号就可以在行内引用代码了 。

我们再来说引用多行代码的方法：

‘‘‘

public static void main(){

}

‘‘‘

public static void main(){

}

引用多行代码的方式就是在代码上下分别加三个撇号。

列表

列表一般有两种情况，一种是无序列表，一种是有序列表。

使用无序列表的方法如下：

- 列表
- 列表
- 列表
  • 列表
  • 列表
  • 列表

无序列表的使用方式是，减号+空格+文字。空格务必不能丢掉。

有序列表的使用只是把减号换成了数字标号：

1. 列表
2. 列表
3. 列表
  1. 列表
  2. 列表
  3. 列表

有序列表的语法是 编号+点+空格+文字。也许你会奇怪，这样写有什么意义呢。

那我们换一种写法。

1. 列表
1. 列表
1. 列表
  1. 列表
  2. 列表
  3. 列表

你会发现，它展现的还是123。

除了无序列表和有序列表，列表还有一个概念就是多级列表：

- 一级列表
一级列表内容
  - 二级列表
二级列表内容
    - 三级列表
三级列表内容
  • 一级列表

    一级列表内容

  • 二级列表

    二级列表内容

    • 三级列表

      三级列表内容

只需要在列表前边加个tab就可以了。

链接

下面为大家介绍如何使用Markdown加入链接：

这是百度的[链接](http://www.baidu.com.cn)

这是百度的链接

这是最普通的加入链接的方式，中括号内是会触发链接的文字，小括号内是链接的地址。

还有一种页内链接，可以跳转到指定的标题：

跳到加粗的链接：[链接](#加粗)

跳到加粗的链接：链接

只要在写链接的小括号中写上 井号+标题，即可。但是有的Markdown编辑器对页内链接功能支持并不友好，比如简书。

当然，链接还支持相对路径链接。

表格

表格的写法如下：

|表头一|表头二|表头三|
|-|-|-|
|内容一|内容二|内容三|
|内容一二三|内容四五六|内容七八九|
表头一 表头二 表头三
内容一 内容二 内容三
内容一二三 内容四五六 内容七八九

表格也可以设置左对齐，右对齐和居中：

|左对齐|右对齐|居中|
|:-|-:|:-:|
|内容一|内容二|内容三|
|内容一二三|内容四五六|内容七八九|
左对齐 右对齐 居中
内容一 内容二 内容三
内容一二三 内容四五六 内容七八九

引入图片

引入图片的方法如下：

![百度Logo](http://www.baidu.com/img/baidu_jgylogo3.gif)

叹号开头，中括号中为图片的alt，小括号中为图片的地址。

以上就是标准Markdown语言的基本用法。Markdown在不同的平台中还有不同的功能拓展，大家可以在使用那些平台的时候再去查阅相关的帮助文档。

原文地址：https://www.cnblogs.com/meibaorui/p/markdown_tutorial.html

时间： 2024-10-21 14:31:22

Markdown使用教程的相关文章

Markdown简明教程4-Markdown UML图

1. 前言 Markdown是一种轻量级的标记语言,把作者从繁杂的排版工作中解放出来,实现易读易写的文章写作,已经逐渐成为事实上的行业标准.CSDN博客支持Markdown可以让广大博友更加专注于博客内容,大赞.但是,不少博友可能对Markdown比较生疏,本博接下来用一个系列文章<Markdown简明教程>扼要介绍Markdown,希望可以对大家有所帮助. 系列教程目录 关于Markdown Markdown基本使用 Markdown表格和公式 Markdown UML图 CSDN Mark

《CSDN Markdown简明教程》课程上线！

0. 目录 目录 前言 课程详情 课程介绍 课程目标 课程目录 课程简介 快速上手1-文本格式化 快速上手2-代码格式化和列表 快速上手3-链接和图片 快速上手4-目录脚注和表格 公式编辑 UML图绘制-序列图 UML图绘制2-流程图 健步如飞 参考博文 等待您的建议 声明 1. 前言 为提高广大C友 Markdown水平,响应CSDN号召,本博录制<CSDN Markdown简明教程>专栏的配套视频教程,业已上线,请广大C友批评指正! 2. 课程详情 <CSDN Markdown简明教

Markdown简明教程5-CSDN Markdown快速上手

0.目录 目录 前言 CSDN Markdown特点 CSDN Markdown快速上手 1 使用快捷键 粗体斜体 引用 链接 高亮代码块 图片 标题 列表 分割线 撤销重复 2 使用离线写作 3 使用导入导出 4 个性定制文章模板 声明 1. 前言 Markdown是一种轻量级的标记语言,把作者从繁杂的排版工作中解放出来,实现易读易写的文章写作,已经逐渐成为事实上的行业标准.CSDN博客支持Markdown可以让广大博友更加专注于博客内容,大赞.但是,不少博友可能对Markdown比较生疏,本

Markdown新手教程

Markdown新手教程 什么是Markdown? Markdown是一种轻量级标记语言.它允许人们"使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档".Markdown 的设计目的是方便写作的时候,标记格式.同时使标记格式后的纯文本,比起 HTML 源码,更有可读性. 用Markdown写作有什么优缺点? 概括来讲,Markdown有如下优点: - 语法比HTML简单,并且能实现大部分HTML能实现的功能 - 格式排版良好,简单直观,可读性强 有哪些比

Markdown 使用教程

前言 以前经常在 github 中看到 .md 格式的文件,一直没有注意,也不明白为什么文本文档的后缀不是 .txt ,后来无意中看到了 Markdown,看到了用这个东西写得一些web界面等特别的规整漂亮,顿时不明觉厉.后来自己学习了一下,感觉这个语言确实简洁.美观,现推荐出来供大家学习和玩玩,希望能对你有用. 本文图文并茂,避免了单纯看语法的枯燥和繁琐,其实,学习一门新东西真的其乐无穷! 简介 Markdown 是一种用来文本处理的轻量级 「标记语言」,它用简洁的语法代替排版,而无需像Mic

最完整的Markdown基础教程

最完整的Markdown基础教程 最完整的Markdown基础教程 最完整的Markdown基础教程 原文地址:https://www.cnblogs.com/fanlinglong/p/12298439.html

GitHub官方Markdown语法教程

说明:Markdown随着编译器不一样,语法也都不一样,但这份GitHub提供的官方教程,基本学会这份就够了. https://guides.github.com/features/mastering-markdown/ https://guides.github.com/pdfs/markdown-cheatsheet-online.pdf 原文地址:https://www.cnblogs.com/EasonJim/p/8463510.html

Markdown 简明教程

基本介绍 Markdown是一种用来写作的轻量级标记语言. 用标记语法,来代替常见的排版格式. 兼容 HTML代码. 特殊字符自动转换,例如<和&. 字体效果 使用星号*和底号_表示em标签. 例如: *斜体* _斜体_ 效果: 斜体 使用双星号**和双底号__表示strong标签. 例如: **强调** __强调__ 效果: 强调 标题 生成h1,h6标签,是通过在文字前面加上同等个数#符号来实现. 出于美观,也可以使用对称的闭合式标题符号. 例如: ## 这是标题 ## 这是标题 ##

Markdown入门教程

Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用.看到这里请不要被「标记」.「语言」所迷惑,Markdown 的语法十分简单.常用的标记符号也不超过十个,这种相对于更为复杂的HTML 标记语言来说,Markdown 可谓是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果. 认识 Markdown 在刚才的导语里提到,Markdown 是一种用来写作的轻量级「标记语言」,它用简洁的语法代替排版,而不像一般我们用的字