码迷,mamicode.com
首页 > 其他好文 > 详细

Markdown基础教程

时间:2021-04-22 16:11:37      阅读:0      评论:0      收藏:0      [点我收藏+]

标签:水平线   文件   func   ber   mes   fun   引用   基本   oob   

什么是Markdown?

Markdown是一种轻量级的标记语言,可用于将格式设置元素添加到纯文本文档中。由John Gruber(约翰·格鲁伯)于2004年创建。Markdown编写的文档可以导出HTML、Word、图像、PDF、Epub等多种格式的文档。文档后缀为.md,.markdown。

为什么要使用Markdown?

  1. 独立于平台。Markdown本身是纯文本,可以在运行任何操作系统的任何设备上创建Markdown格式的文本。

  2. 版本兼容性。不会因软件升级产生不同版本之间的兼容性问题。

  3. 便携式。几乎可以使用任何应用程序打开包含Markdown格式的文件。

编辑器

本教程将使用Typora编辑器来熟悉Markdown的语法,Typora支持MacOs、Windows、Linux等平台。

支持导出的格式:PDF、HTML、Word、Txt、图像等等。

ypora官网:https://typora.io

语法

标题

  1. 使用=和-标记一级和二级标题

    语法:

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

    效果:

    一级标题

    二级标题

  2. 使用#号标记1-6级标题(#号后加一个空格)

    语法:

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

    效果:

    一级标题

    二级标题

    三级标题

    四级标题

    五级标题
    六级标题

字体

Markdown可以使用以下几种字体。

?

*斜体文字*
_斜体文字_
**粗体文字**
__粗体文字__
***粗斜体文字***
___粗斜体文字___

效果:

斜体文字
斜体文字
粗体文字
粗体文字
粗斜体文字
粗斜体文字

列表

  1. 无序列表(*、+、-后加一个空格)

    语法:

    * 你
    * 好
    * 呀
    
    + 你
    + 好
    + 呀
    
    - 你
    - 好
    - 呀
    

    效果:

  2. 有序列表(使用数字加一个.号)

    语法:

    1.你
    2.好
    3.呀
    

    效果:

  3. 列表嵌套

    列表前他只需要在子列表前面加四个空格。

    语法:

    1. 你
        - 你
        - 好
    2. 好
        - 你
        - 好
    

    效果:

区块

Markdown区块引用是在段落开头使用>符号,后面紧跟一个空格:

> 区块引用
> 你
> 好

? 效果:

区块引用

? 区块是可以嵌套的,一个>符号为最外层,两个>为第二层,以此类推:

> 最外层
>> 你
>>> 好

? 效果:

最外层

区块中使用列表

语法:

> 区块中使用列表
> 1. 你
> 2. 好
> * 你
> * 好

效果:

区块中使用列表

列表中使用区块

语法:

* 你
	> 你
	> 好
* 好

效果:


代码

  1. 如果是段落上的一个函数或片段的代码可以用 反引号(`)把它包起来。语法:

    `print()`函数
    

    效果:

    print()函数

  2. 代码区块

    代码区块使用4个空格或者1个制表符(Tab键)。语法:

    	<!DOCTYPE html>
    	<html lang="zh-cn" dir="ltr" >
    

    效果:

    <!DOCTYPE html>
    <html lang="zh-cn" dir="ltr" >
    

    也可以使用3个反引号(```)包裹一段代码。

    语法:

    ?```javascript
    $(document).ready(function(){
    	alert(‘你好!‘);
    });
    ?```
    

    效果:

    $(document).ready(function(){
    	alert(‘你好!‘);
    });
    

水平线

使用3个或更多的星号(*)或者下划线(_)。

语法:

你
*********
好
_________

效果:



链接

基本语法:

[连接名称](连接地址)
或者
<连接地址>

效果:

点我打开百度

或者

https://www.baidu.com/

高级链接

通过变量来设置一个链接,变量赋值在文档末尾进行:

这个链接使用 1 作为网址变量 [Google][1]
这个链接使用 你 作为网址变量[Baidu][你]

[1]:http://www.google.com/
[你]:https://www.baidu.com/

效果:

这个链接使用 1 作为网址变量 Google
这个链接使用 你 作为网址变量Baidu

图片

语法:

![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")

![RUNOOB 图标](http://static.runoob.com/images/runoob-logo.png)
![RUNOOB 图标](http://static.runoob.com/images/runoob-logo.png "RUNOOB")

效果:

技术图片
技术图片

表格

语法:

使用|来分隔不同单元格,使用-来分割不同行。

|列1 |列2|
|--- |---|
|你  |好 |

对齐方式:

-:右对齐

:-左对齐

:-:  居中对齐

|左对齐|居中对齐|右对齐|
|:----|:-----:|----:|
|你   |好	    |呀	  |

效果:

列1 列2
左对齐 居中对齐 右对齐

支持的HTML元素

不在Markdown涵盖范围之内的标签,都可以直接在文档里面用HTML标签撰写。

目前支持的HTML元素有:<kbd> <b> <i> <em> <sup> <sub> <br>等。语法:

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑
你<br>好
a<sub>n</sub>
a<sup>x</sup>

效果:

使用 Ctrl+Alt+Del 重启电脑


an
ax

转义

Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符:

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

效果:

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

公式

当你需要在编辑器中插入数学公式时,可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。如:

$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
\mathbf{i} & \mathbf{j} & \mathbf{k} \\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\end{vmatrix}
${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$

效果:

\[\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\end{vmatrix} ${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}} \]

Markdown基础教程

标签:水平线   文件   func   ber   mes   fun   引用   基本   oob   

原文地址:https://www.cnblogs.com/yela/p/14686885.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!