Markdown 快速入门上（基础语法篇）

最新推荐文章于 2022-03-07 12:05:58 发布
最新推荐文章于 2022-03-07 12:05:58 发布
阅读量336 收藏
点赞数
分类专栏： MISC 文章标签： markdown
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq314942468/article/details/108675936
版权

Markdown 快速入门上（基础语法篇）

1. 简介

Markdown 是一门轻量级的标记性语言，可以用来修饰纯文本使得文档具有一定的优美格式。
像Microsoft Word 文本编辑器， 你需要点击按钮来格式化文档的内容， 并且修改后的内容是实时反馈的， 但是Markdown 不一样，当你在编辑一个Markdown格式的文档时，你只需要在纯文本中插入Markdown语法，被语法标注的纯文本就能根据你的需求显示不同的效果。

这样你就只需要使用普通的纯文本编辑器，比如Sublime就可以写出比较漂亮的文档出来，而且可以通过安装插件显示出文档的格式效果来。由于Markdown只是一种语言，因此编辑出来的文档具有很好的跨平台性，这就意味着你在Win平台下面编辑的文档不需要做任何修改就可以在Linux或者MAC下直接显示效果。另外还有一些在线的网站，如简书可以直接进行Markdown的编辑和显示。这对程序员写文档来说绝对是一个福音， 我们不仅可以用Markdown来记录自己的知识，还能在必要的时候不需要进行任何额外的修改就能放到一些主流网站上去与其他的人一起分享。

为什么使用Markdown

  • Markdown 可以用来编辑任何性质和形式的文档。人们可以用来编辑网站档案，笔记，出版书，论文，邮件和技术文档等等。

  • Markdown 灵活性很强。Markdown格式的文档不限制使用哪一种应用来打开。如果你不满意你现在正在使用的Markdown应用，你可以选择一款你更喜欢的应用，市面上有很多编辑器直接或通过插件就能方便预览文档Markdown格式。这与一般的文字处理应用如Microsoft Word 就有很大的区别， 一般Word 编辑的格式只能通过Word或者同类兼容软件来打开，这样在做文档分享时候有时会遇到很大的麻烦，甚至需要重新编辑，费时费力。

  • Markdown与平台无关。你可以在任何操作系统中打开Markdown文档。

  • Markdown无处不在。像Reddit和GitHub网站都是支持Markdown的，并且越来越多的网站会加入到Markdown队列中来，这是一个趋势。

2. 基本语法

Markdown的语法可以分为基本语法 和扩展语法， 市场的Markdown应用都应该支持基本语法。

一、标题

Markdown 在创建标题时需要在文字或者段落的前面加上**#符号，#**的数量取决于当前标题的级别，如下

  • 示例
    # 一级标题
    ## 二级标题
    ### 三级标题
    #### 四级标题
    ##### 五级标题

  • 效果

一级标题

二级标题

三级标题

四级标题
五级标题

对于一级标题和二级标题还有一种语法可以来标记，可以在一级标题下面加任意数量的**==， 在二级标题下加任意数量的–**，具体效果如下

  • 示例

一级标题
====
二级标题
----

  • 效果

一级标题

二级标题

二、段落

创建段落时候 ，可以使用空行来隔离一行或者多行。除非段落是列表， 否则不要使用空格或者TAB来缩进段落。

  • 示例

    散文，汉语词汇，拼音是sǎn wén。一指文采焕发；二指犹行文； [1] 三指文体名。随着时代的发展，散文的概念由广义向狭义转变，并受到西方文化的影响。

    散文是一种抒发作者真情实感、写作方式灵活的记叙类文学体裁。“散文”一词大概出现在北宋太平兴国(976年12月-984年11月)时期。

    《辞海》认为：中国六朝以来，为区别韵文与骈文，把凡不押韵、不重排偶的散体文章(包括经传史书)，统称“散文”。后又泛指诗歌以外的所有文学体裁。

三、强调（字体）

Markdown可以将字体格式化为加粗或者斜体。

  1. 加粗

在文字前后都加上两个星号或者下划线来将其中间的文字加粗, 注意的是星号或者下划线与文字之间不能有空格。

  • 示例

散文是一种抒发作者真情实感、写作方式灵活的**记叙类**文学体裁。

散文是一种抒发作者真情实感、写作方式灵活的 _记叙类_ 文学体裁。

  • 效果

散文是一种抒发作者真情实感、写作方式灵活的记叙类文学体裁。

散文是一种抒发作者真情实感、写作方式灵活的 记叙类 文学体裁。

需要注意的是有时候下划线无法处理连续文字的中间部分，这个时候就需要使用星号来处理。所以一般的，推荐使用星号来加粗。

Do thisDon’t do this
Love**is**boldLove__is__bold
  1. 斜体

在文字前后都加上单个星号或者下划线来将其中间的文字加粗, 注意的是星号或者下划线与文字之间不能有空格。

  • 示例

散文是一种抒发作者真情实感、写作方式灵活的*记叙类*文学体裁。

散文是一种抒发作者真情实感、写作方式灵活的 _记叙类_ 文学体裁。

  • 效果

散文是一种抒发作者真情实感、写作方式灵活的记叙类文学体裁。

散文是一种抒发作者真情实感、写作方式灵活的 记叙类 文学体裁。

需要注意的是有时候下划线无法处理连续文字的中间部分，这个时候就需要使用星号来处理。所以一般的，和加粗一样推荐使用星号来加粗。

Do thisDon’t do this
Love*is*boldLove_is_bold
  1. 加粗并倾斜

在文字前后都加上三个连续的星号或者下划线来将其中间的文字加粗并倾斜, 注意的是星号或者下划线与文字之间不能有空格。使用方法和上面两种一致。这里仅以星号为例：

  • 示例

散文是一种抒发作者真情实感、写作方式灵活的*记叙类*文学体裁。

  • 效果

散文是一种抒发作者真情实感、写作方式灵活的***记叙类***文学体裁。

四、引用块

Markdown在每行使用一个**>来标记引用一行，自然在引用多行时就需要在多行都使用>**来标记，并且可以和其它标记元素嵌套使用。

  1. 多行引用

  • 示例
    > ## 绝句
    >两个*黄鹂**鸣翠柳，一行白鹭上青天。
    >
    >窗含西岭*千秋雪    ，门泊东吴万里船。

  • 效果

## 绝句

两个黄鹂鸣翠柳，一行白鹭上青天。

窗含西岭千秋雪，门泊东吴万里船。

  1. 嵌套引用

Markdown可以在每行多个**>来嵌套引用，>**的个数表示引用嵌套的层数。

  • 示例

>两个黄鹂鸣翠柳，一行白鹭上青天。
>>两个黄鹂鸣翠柳，一行白鹭上青天。
>>>两个黄鹂鸣翠柳，一行白鹭上青天。
>>>>两个黄鹂鸣翠柳，一行白鹭上青天。
>>>>>两个黄鹂鸣翠柳，一行白鹭上青天。

  • 效果

两个黄鹂鸣翠柳，一行白鹭上青天。

两个黄鹂鸣翠柳，一行白鹭上青天。

两个黄鹂鸣翠柳，一行白鹭上青天。

两个黄鹂鸣翠柳，一行白鹭上青天。

两个黄鹂鸣翠柳，一行白鹭上青天。

五、列表

Markdown中列表可以分为两种，分别是有序列表和无序列表。列表可以与其他的标记符号进行嵌套使用。

有序列表

在纯文本前面加数字和英文句号表示一个有序列表。注意其中Markdown 语法没有要求数字是连续的，但是列表必须以数字1开头。显示效果会自动从1开始递增。

  • 示例

\1. 第一项
\3. 第二项
\5. 第三项
\4. 第四项

  • 效果
  1. 第一项
  2. 第二项
  3. 第三项
  4. 第四项
无序列表

无序列表可以在文本前面通过使用破折号（-），星号（*），或者加号（+）中的任意一种来标记。并且通过缩进来表示嵌套的列表。以下以加号（+）作为例子来演示。

  • 示例

    + 第一项
    + 第二项
    + 嵌套列表第一项
    + 嵌套列表第二项
    + 第三项

  • 效果

    • 第一项
    • 第二项
      • 嵌套列表第一项
      • 嵌套列表第二项
    • 第三项

注意在一个列表中请务必使用同一种标记符号。

有序列表和无序列表嵌套
  • 示例

\1. 第一项
\3. 第二项
\5. 第三项
+ 嵌套第一项
+ 嵌套第二项
\4. 第四项

  • 效果
  1. 第一项
  2. 第二项
  3. 第三项
    • 嵌套第一项
    • 嵌套第二项
  4. 第四项

六、 图片

在Markdown文档中插入图片的基本语法如下：

  • 语法： ![tag](link address"title")
    • tag： 用来描述图片的关键词
    • link address: 图片的绝对地址，可以是本地的也可以是网络的
    • title: 当鼠标悬置于图片上时，出现的文字标题内容
  • 示例
    ![cute_cat](https://camo.githubusercontent.com/d518d3929e4054ce2f9183b23e52908da7e5632d/687474703a2f2f692e696d6775722e636f6d2f736732646b75592e706e673f31"cute_cat")
  • 效果
    cat

由于本地图片只能在本地引用，这样在其他平台打开的话，图片就会失效，这个时候有一种方法就是将图片放在永久有效的网络服务器上，称之为图床。这里关于创建图床的方法可以参考： 图床连接简书连接 。

七、 代码

  1. 代码

一般地需要将文字或者段落表示为代码时，可以使用反引号来标记（`）. 当段落中原本就有反引号的情况下需要使用双反应号来标记（``）

  • 示例

At the command prompt, type `nano`.
``At the command prompt, type `nano`. ``

  • 效果

At the command prompt, type nano.
At the command prompt, type `nano`.

  1. 列表中代码块

在Markdown中一般的代码块是通过缩进四个空格或者一个Tab来标记的。但是当这部分代码块是嵌套在列表中时，必须使用八个空格或者两个Tab来标记。

  • 效果

    1. Open the file.

    2. Find the following code block on line 21:

      <html>
  <head>
    <title>Test</title>
  </head>

    3. Update the title to match the name of your website.

八、水平分割线

水平分割线可以用三个或者多个星号 (***), 破折号(—), or 下划线(___) 来标记。为了兼容性，推荐在水平分割线前后加上空行。

  • 示例

***
—
___

  • 效果

九、 超链接

在Markdown文档中插入超链接的基本语法主要有两种，每一种都可以与其它标记符号嵌套使用。

  1. 带标题的超链接

  • 语法： [title](URL Address)

    • title： 在文档中显示的关于超连接诶的提示内容
    • URL Address: 超链接地址

  • 示例

前面在图片章节实际上已经插入过超链接，这里再次作为示例来演示。
**[图床连接简书连接](https://www.jianshu.com/p/ea1eb11db63f)**

  • 效果

图床连接简书连接

  1. 直接显示地址的超链接
    Markdown中可以直接将URL或者邮箱地址直接放在尖括号中间来标记为插连接，鼠标点击该链接即可跳转到对应网页上去。对于点击邮箱地址，如果你安装了邮箱应用，那就直接跳转到写邮件页面。
  • 示例

<https://www.jianshu.com/p/ea1eb11db63f>

  • 效果

https://www.jianshu.com/p/ea1eb11db63f

十、 转义字符

由于标记字符都是作为格式化用途并不能被显示，markdown 和大多数其他语言一样使用反斜杠(\) 号来转义，意思就是不要把\ 后面的地府识别为标记字符。

可被转义的标记字符如下表：

标记字符名字
\backslash
`backtick (see also escaping backticks in code)
*asterisk
-underscore
{ }curly braces
[ ]brackets
( )parentheses
#pound sign
+plus sign
-minus sign (hyphen)
.dot
!exclamation mark
|pipe (see also escaping pipe in tables)
地平线上的程序员
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Python-Remarkable一个用于Linux的开源Markdown编辑器
08-10
Remarkable - 一个用于Linux的开源Markdown编辑器
markdown 快速入门
雪之梦技术驿站
03-06 242
markdown 不止是 HTML 的简化版,更重要的是 txt 的升级版,word 的轻量版,是笔记的最佳载体. markdown 作为一种简单的格式标记语言,不同于 txt 的无格式,不同于 HTML 的复杂标记,也不同于 word 的鼠标调整样式. markdown 通过简单的几个字符键入,就可以快捷的定义文档的样式. 掌握 markdown,你可以完全抛弃 txt 和笔记软件的编辑器,并且...
Markdown快速入门
itmyhome的专栏
01-22 2685
Markdown语法虽然很多，但真正用到的其实并不多，以下语法基本可以涵盖我们平常所使用到的段落、标题、区块代码一个段落是由一个以上的连接的行句组成，而一个以上的空行则会划分出不同的段落Markdown支持两种标题的语法，Setext和atx形式。Setext形式是用底线的形式，利用 = (最高阶标题)和 - (第二阶标题)，Atx形式在行首插入1到 6个# ，对应到标题1到6阶。区块引用则使用e
MarkDown语法快速入门
m0_62903487的博客
02-22 193
是不是总在各大项目中看见一个README.md的文件却不知道它是什么意思呢，本篇文章不仅会对这种以.md为后缀的文件进行解释，也会提出一些基本用法。 学习总是要经过完整的逻辑思维过程 是什么 为什么 怎么做 本篇文章的MarkDown语法快速入门就围绕着这三点 一.MarkDown是什么 Markdown是一种轻量级标记语言，创始人为约翰·格鲁伯（英语：John Gruber）。 它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。 由于Markdown的轻量化
Markdown快速入门语法总结
10-30
markdown语法可以用于在网页上方便的书写文档，常用的场合为在GitHub上写readme文档，本文简要总结了markdown最基础的语法，并附上了示例图片
Markdown语法入门_markdown_
10-03
Markdown基础语法，介绍有关Markdown语法的基本操作
devii：2020年的开发人员博客入门（Next.js + React + TypeScript + Markdown +语法突出显示）
02-03
然后，您可以剔除您不喜欢的所有内容，自定义其他所有内容，并在Devii提供的基础之上构建自己的工具和组件！ 您的个人网站是您的在线展示。 Devii实际上并没有提供太多功能。 它为您的博客文章提供了一些不错的中型...
Homework.markdown
01-08
markdown基础学习，可以快速markdown入门，学习和了解一些简单的语法。时间短并且高效，可以相互学习
微信小程序从入门到高手开发资源汇总
08-11
同微信原生视觉体验一致的基础样式库 高颜值、好用、易扩展的微信小程序 UI 库 微信小程序富文本解析自定义组件，支持 HTML 及 markdown 解析 小程序富文本组件，支持渲染和编辑 html，支持在微信、QQ、百度、支付宝...
快速入门Markdown
Rust94的博客
03-19 367
什么是Markdown? Markdown是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。Markdown具有一系列衍生版本，用于扩展Markdown的功能（如表格、脚注、内嵌HTML等等），这些功能原初的Markdown尚不具备，它们能让Markdown转换成更多的格式，例如LaTeX，Docbook。Markdown增强版中比较有名
markdown使用效果
qq_37077760的博客
10-16 481
效果 （源码） markdown markdown标题 使用#号标记 1-6级标题 markdown段落 Markdown 段落没有特殊的格式，直接编写文字就好，段落的换行是使用两个以上空格加上回车。 当然也可以在段落后面使用一个空行来表示重新开始一个段落。 字体 斜体文本 斜体文本 粗体文本 粗体文本 粗斜体文本 粗斜体文本 分割线 你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线： 删除线 如果段落上的文字
Markdown快速入门教程(我的笔记)
子殊的博客
05-09 366
本人大一小白一枚，第一次写博客，万字长文，总结一下自己学习的Markdown知识。推荐阅读书目《了不起的Markdown》 Markdown教程 Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。 Markdown 语言在 2004 由约翰·格鲁伯（英语：John Gruber）创建。 Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。 Markdown编写的文档后缀为 .md, .markdown。 Markdown标题
MarkDown快速入门教学
qq_40757399的博客
03-07 137
一、标题 标题是使用 # xxx，‘#’开头，多少个#，就代表着Hx（1-6）级。 二、代码块 代码块是以 ```开头与结束，即生成代码块，也可以+语言名称生成特定的编程语言代码块。 function(){ } 三、字体 1、加粗 内容的左右两边 加两个* 2、高亮显示 内容左右两边加两个= 3、删除线 内容左右两边加两个~ 4、斜体 内容左右两边*加一个** 四、引用 引用为>,且具有层级，最大层级为一个>,下一级是>>，以此类推 123 456 789 五
Markdown入门之基本语法
CoolGIS的技术博客
09-01 85
Markdown 是一种轻量级的标记语言，可用于在纯文本文档中添加格式化元素。本文对Markdown基本语法做归纳介绍。
markdown语法入门
最新发布
09-11
Markdown语法是一种轻量级标记语言，常用于写作、文档编写和博客发布等场景。...这只是Markdown语法的基础部分，还有更多高级用法，如表格、水平分割线等。你可以在CSDN等网站上找到更详细的Markdown语法教程。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值