服务器之家:专注于VPS、云服务器配置技术及软件下载分享
分类导航

PHP教程|ASP.NET教程|Java教程|ASP教程|编程技术|正则表达式|C/C++|IOS|C#|Swift|Android|VB|R语言|JavaScript|易语言|vb.net|

服务器之家 - 编程语言 - 编程技术 - markdown简介和语法介绍

markdown简介和语法介绍

2020-07-28 16:59编程技术网 编程技术

这篇文章主要介绍了markdown简介和语法介绍,本文重点介绍了常用的一些markdown语法,可以做为一个简明版的入门指南,另本文还提供了一个在线学习markdown的简明教程,需要的朋友可以参考下

一、前言

之前有了解过markdown,但一直没实际使用,今天试用了下,感觉很爽,推荐给大家,特别是在编写规范、接口文档等方面非常适合,因为其简单易用也有很多人用来写网络小说。

二、介绍

Markdown 的目标是实现易读易写,可以直接在问编辑器书写和保存,除本身具有非常好的可读写外,还可以生存格式非常好看的html代码发布在互联网中。

如链接:服务器之家,其书写格式为:

[服务器之家](http://www.tuohang.net/)

Markdown 不是想要取代 HTML,甚至也没有要和它相近,它的语法种类很少,只对应 HTML 标记的一小部分。Markdown 的构想不是要使得 HTML 文档更容易书写。在我看来, HTML 已经很容易写了。Markdown 的理念是,能让文档更容易读、写和随意改。HTML 是一种发布的格式,Markdown 是一种书写的格式。就这样,Markdown 的格式语法只涵盖纯文本可以涵盖的范围。

三、语法介绍

(一)区块元素

段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。普通段落不该用空格或制表符来缩进。

「由一个或多个连续的文本行组成」这句话其实暗示了 Markdown 允许段落内的强迫换行(按入两个以上的空格然后回车)

标题

Markdown 支持两种标题的语法,类 Setext 和类 [atx][2] 形式,我们这里只介绍我建议使用的Atx 形式. 类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如:

复制代码 代码如下:

# 这是H1
## 这是 H2
###### 这是H6

 

区块引用 Blockquotes

Markdown 标记区块引用是使用类似 email 中用 > 的引用方式,如:

复制代码 代码如下:

>这是一个区块引用 
>这是一个区块引用


展现形式为:

 

这是一个区块引用
这是一个区块引用

列表

Markdown 支持有序列表和无序列表。

无序列表使用星号、加号或是减号作为列表标记:如:

 

复制代码 代码如下:

*   Red
*   Green
*   Blue

 

有序列表则使用数字接着一个英文句点:

复制代码 代码如下:

1.  Bird
2.  McHale
3.  Parish

 

代码区块

这功能应该是我们程序员最喜欢的功能,在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,有些还支持代码高亮。

复制代码 代码如下:


这是一个普通段落

 

    这是一个代码区块。

 

分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

复制代码 代码如下:


* * *

 

***

*****

- - -

---------------------------------------

 

(二)区段元素

链接

Markdown 支持两种形式的链接语法: 行内式和参考式两种形式

不管是哪一种,链接文字都是用 [方括号] 来标记。

这里只介绍行内式,参考式可以访问本文后面的参考链接详细了解。

要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可,例如:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

强调

Markdown 使用星号(*)和底线(_)作为标记强调字词的符号,被 * 或 _ 包围的字词会被转成用 <em> 标签包围,用两个 * 或 _ 包起来的话,则会被转成 <strong>,例如:

复制代码 代码如下:


*single asterisks*

 

_single underscores_

**double asterisks**

__double underscores__

 

代码

如果要标记一小段行内代码,你可以用反引号把它包起来(`),例如:

则会被转成 `<strong>`

图片

很明显地,要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。 Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。 这里也只介绍行内式:

复制代码 代码如下:


![Alt text](/path/to/img.jpg)

 

![Alt text](/path/to/img.jpg "Optional title")

 

详细叙述如下:

一个惊叹号 !
接着一个方括号,里面放上图片的替代文字
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 ‘title' 文字。

(三)其它

自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:

复制代码 代码如下:

<http://example.com/>
<address@example.com>


Markdown 会转为:

复制代码 代码如下:

<a href="http://example.com/">http://example.com/</a>
<a href="mailto:address@example.com">address@example.com</a>

 

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号,例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 <em> 标签),你可以在星号的前面加上反斜杠: literal asterisks Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

复制代码 代码如下:

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

 

markdown编辑器

markdown的编辑器基本都支持实时预览功能,下面介绍几个我在用的。

1.我自己在用的woidows markdown编辑器是markdownpad 2,觉还不错
2.在线编辑器有mahua
3.wordpress编辑器:wp-markdown

参考链接

Markdown 语法说明 (简体中文版):http://wowubuntu.com/markdown/

延伸 · 阅读

精彩推荐
  • 编程技术从Context源码实现谈React性能优化

    从Context源码实现谈React性能优化

    这篇文章主要介绍Context的实现原理,源码层面掌握React组件的render时机,从而写出高性能的React组件,源码层面了解shouldComponentUpdate、React.memo、PureComponen...

    魔术师卡颂5312020-12-20
  • 编程技术真正聪明的程序员,总有办法不加班

    真正聪明的程序员,总有办法不加班

    工作效率提升了,就可以少加班了,聪明的程序员,总会有一堆可以提升编码效率的工具?当一种工具满足不了工作需求,就去探索新的,今天纬小创就给...

    今日头条12482021-03-04
  • 编程技术让开发效率倍增的 VS Code 插件

    让开发效率倍增的 VS Code 插件

    今天来分享一些提升开发效率的实用 VS Code 插件!Better Comments 扩展可以帮助我们在代码中创建更人性化的注释,有不同形式和颜色的注释供我们选择。 ...

    前端充电宝7132022-04-21
  • 编程技术AIOps,SRE工程师手中的利器

    AIOps,SRE工程师手中的利器

    AIOps开始成为一种极为重要的站点可靠性工程工具。它能够高效吸纳观察数据、参与数据以及来自第三方工具的数据,判断系统运行状态并保证其处于最佳...

    至顶网5962021-03-08
  • 编程技术用户态 Tcpdump 如何实现抓到内核网络包的?

    用户态 Tcpdump 如何实现抓到内核网络包的?

    在网络包的发送和接收过程中,绝大部分的工作都是在内核态完成的。那么问题来了,我们常用的运行在用户态的程序 tcpdump 是那如何实现抓到内核态的包...

    开发内功修炼11612021-09-08
  • 编程技术简单、好懂的Svelte实现原理

    简单、好懂的Svelte实现原理

    本文会围绕一张流程图和两个Demo讲解,正确的食用方式是用电脑打开本文,跟着流程图、Demo一边看、一边敲、一边学...

    魔术师卡颂4822021-11-10
  • 编程技术2021年值得关注的React PDF 库

    2021年值得关注的React PDF 库

    今天,许多网络应用程序为其用户提供内置的PDF浏览选项。然而,选择一个并不容易,因为它们的功能远远超过显示PDF。在这篇文章中,我将评估5个React的...

    TianTianUp5222021-06-21
  • 编程技术Delphi - Indy idMessage和idSMTP实现邮件的发送

    Delphi - Indy idMessage和idSMTP实现邮件的发送

    这篇文章主要介绍了Delphi - Indy idMessage和idSMTP实现邮件的发送,本文通过实例代码给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下...

    JJ_JeremyWu6592020-09-22