Markdown语法

简介: Markdown是一个Web上使用的文本到HTML的转换工具,可以通过简单、易读易写的文本格式生成结构化的HTML文档。目前GitHub、Stackoverflow等网站均支持这种格式。

1.2 Markdown的优点:
1.专注你的文字内容而不是排版样式
2.轻松的导出HTML、PDF和本身的.md文件
3.纯文本内容,兼容所有的文本编辑器与字处理软件
4.可读,直观。适合所有人的写作语言
1.3 Markdown兼容HTML
HTML是一种发布的格式,Markdown是一种书写的格式。Markdown的格式语法只涵盖纯文本可以涵盖的范围,不在Markdown涵盖范围之内的标签,都可以直接在文档里面用HTML撰写。不需要额外标注这是HTML或是Markdown;只要直接加标签就可以了。

要制约的只有一些HTML区块元素——比如

等标签,必须在前后加上空行与其他内容区隔开,还要求它们的标签与结尾标签不能用制表符或空格来缩进。Markdown的生成器有足够智能,不会在HTML区块标签外加上不必要的

标签。

在HTML 区 块 \color{red}{区块}区块标签间的Markdown格式语法将不会被处理,在HTML区 段 \color{red}{区段}区段标签间Markdown语法是生效的。

  1. Markdown的语法

2.1 Markdown的自动符号的转换语法
HTML:有两个字符需要特殊处理:< 和 & 。< 符号用于起始标签,& 符号则用于标记HTML实体,如果你只是想要显示这些字符的原型,则必须使用实体的形式。(类似于转义字符)例如<:&It;和&:&另外© 可以写成©也可以直接输 ©

Markdown: 这三个字符自动转换,不需要人为转义。如果你使用的&字符是HTML字符实体的一部分,它会保留原状,否则它会被转换成& 。比如:你想要显示

AT&T
1
那么在Markdown中写成

AT&T :这是Markdown的写法
AT&T :这是HTML的正确写法,但是在Markdown中也会被自动转换
1
2
都能达到想要实现的效果。

2.2 Markdown区块元素:段落换行和缩进
一个 Markdown 段落的前后要有一个以上的空行。普通段落不该用空格或制表符来缩进。如果想在段前加缩进

 是一个中文字符  是半个中文字符  是1/4中文字符
1
普通段落也不能用回车来换行(当然如果你使用的是typora的话,可以直接回车创建新段落)

1.使用

内容

来组成封闭的一行
2.使用<br/>换行
  • 当然这会对插入<br/>标签造成麻烦。如果你确实想要依赖Markdown来插入<br/>标签的话,在插入处先按入两个以上的空格然后回车。

1
2
3
2.3 Markdown标题
Markdown支持两种标题的语法,类Setext和类atx形式

类Setext形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),紧挨着显示的标题下一行输入,例如:

第一阶标题

第二阶标题显示效果有下划线

(任意数量的=和-都可以有效果)
类Atx形式则是在行首插入1到6个#,对应到标题1到6阶,例如:
2.4 Markdown标记区块引用(常用于备注说明)
Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。 在每行的最前面加上 >

区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > ,例如:

引用

嵌套引用
效果如下:

引用

嵌套引用

引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等:

这是一个标题。

  1. FirstLine。
  2. SecondLine。

给出一些例子代码:

return shell_exec("echo $input | $markdown_script");

1
2
3
4
5
6
7
8
效果如下:

这是一个标题。
FirstLine。
SecondLine。
给出一些例子代码:

return shell_exec("echo $input | $markdown_script");
1
Markdown也允许你偷懒只在整个段落的第一行最前面加上> :

相关文章
|
1月前
markdown常用语法--花括号(超详细)
markdown常用语法--花括号(超详细)
|
6月前
|
程序员 Windows
markdown的基本语法
markdown的基本语法
53 0
|
30天前
|
IDE 数据可视化 数据挖掘
Jupyter Notebook使用教程——从Anaconda环境构建到Markdown、LaTex语法介绍
Jupyter Notebook使用教程——从Anaconda环境构建到Markdown、LaTex语法介绍
61 2
|
1月前
Markdown的基本语法(一)
Markdown的基本语法(一)
|
2月前
|
开发者
阿里云开发者社区Markdown语法
【2月更文挑战第1篇】
106 0
阿里云开发者社区Markdown语法
|
3月前
|
前端开发 API
MarkDown基础语法
MarkDown基础语法
83 0
|
8月前
轻松写作利器——Markdown常用语法介绍
家人们,今天我想向大家介绍一种广泛应用于写作和文档编辑的工具——Markdown。作为一种简单而高效的标记语言,Markdown在技术圈和写作领域越来越受欢迎。无论你是写程序代码、博客文章还是撰写文档,Markdown都能帮助你以简洁的方式展现内容。让我们一起来了解Markdown的常用语法吧!
70 0
轻松写作利器——Markdown常用语法介绍
|
4月前
|
Dart Shell pouch
markdown中快速插入Emoji表情包语法速查表!!!
markdown中快速插入Emoji表情包语法速查表!!!
|
5月前
|
程序员
markdown模式的一些语法
markdown模式的一些语法
30 0
|
5月前
Markdown语法和表情
Markdown语法和表情
48 0