markdown基本语法

1、前言

Markdown是一种可使用普通文本编辑器编写的标记语言,经过简单的标记语法,它可使普通文本内容具备必定的格式。    --摘自百度百科

没想到一贯不太靠谱的百度百科此次竟有了如此精辟的解释。以前项目一直使用word撰写文档,有比较大的弊病:python

  • 只能对纯文本文件进行版本控制,而word是二进制格式
  • 格式繁杂,常常须要中断写做来控制格式
  • 代码与文档分离,给写文档形成更大的阻力

而假如单纯的使用txt,就没有一点格式了,用html虽然既有格式又能加入版本控制,可是须要花费较多的时间在标签上,并且标签占了文档的较大百分比,不易阅读。markdown

因此,最终的解决方案就是 **Markdown** ,做为一种轻量级的标记语言,能在很是短的时间内掌握。并且不只能够用于写文档,还能够写博客、写简书、作一些随手笔记。Markdown文件以.md结尾,能够导出为html和PDF(须要使用的工具支持)。它是一种语法(我的认为是简化版的html),可是和html不一样的是,各类解析器对其会有不一样的表现。好比个人IDEA Markdown插件会把分割线显示成一条细灰线,Cmd Markdown则是显示一条虚线。因此建议保持使用一种Markdown工具和尽可能使用标准语法。

2、Markdown基本语法

2.1 标题

代码:app

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 最小只有六级标题

效果:编辑器

过于粗暴,不予以展现,你复制粘贴即知晓!!!工具

2.2 加粗

代码:spa

**我被加粗了**

效果:插件

我被加粗了版本控制

2.3 斜体

代码:code

*我倾斜了了*

效果:

我倾斜了了

2.4 高亮

代码:

==我高亮了==

效果:

==我高亮了==

2.5 上标

代码:

2^2^

效果:

2^2^

2.6 下标

代码:

H~2~o

效果:

H~2~o

2.7 代码引用(>式)

代码:

> hello markdown!

效果:

hello markdown!

代码:

> hello markdown!
>> hello markdown!

效果:

hello markdown!

hello markdown!

2.8 代码引用(```式)

代码:

# 不要复制这一句话,而且去掉下面的反斜杠,谢谢!
\`\`\`python
print('hello nick')
\`\`\`

效果:

print('hello nick')

2.9 代码引入(`式)

代码:

# 不要复制这一句话,而且去掉下面的反斜杠,谢谢!
\`print('hello nick')\`

效果:

print('hello nick')

2.10 插入连接(连接显示)

代码:

<https://www.cnblogs.com/nickchen121/p/10718112.html>

效果:

http://www.javashuo.com/article/p-xylvnfya-gg.html

2.11 插入连接(连接描述显示)

代码:

[nickchen博客](https://www.cnblogs.com/nickchen121/p/10718112.html "nickchen博客")

效果:

nickchen博客

2.12 插入图片(连接)

代码:

![数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark](http://www.chenyoude.com/Python从入门到放弃/数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark '描述信息')

效果:

数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark

2.13 插入图片(图片路径)

  • 绝对路径:.md文本同目录下图片的名字,如数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark
  • 相对路径:图片在电脑中的路径地址,如\Users\nick\mac\desktop\数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark

代码:

![数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark](数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark '描述信息')

![数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark](\Users\nick\mac\desktop\数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark '描述信息')

效果:

数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark

数据类型总结-搞笑结束.jpg?x-oss-process=style/watermark

2.14 有序列表

代码:

1. one
2. two 
3. three

效果:

  1. one
  2. two
  3. three

2.15 无序列表

代码:

* one
* two
* three

效果:

  • one
  • two
  • three

2.16 分割线

代码:

---

效果:


2.17 表格并且第二行必须得有,而且第二行的冒号表明对齐格式,分别为居中;右对齐;左对齐):

name | age | sex 
:-:|:-|-:
tony|20|男
lucy|18|女

效果:

name age sex
nick 19
jason 18

2.18 数学公式(行内嵌)

代码:

内嵌数学公式$\sum_{i=1}^{10}f(i)\,\,\text{thanks}$

效果:

内嵌数学公式\(\sum_{i=1}^{10}f(i)\,\,\text{thanks}\)

2.19 数学公式(块状)

代码:

$$
\sum_{i=1}^{10}f(i)\,\,\text{thanks}
$$

效果:

\[ \sum_{i=1}^{10}f(i)\,\,\text{thanks} \]

3、总结

以上所述就是Markdown的基本标签,虽然很少,可是能够解决大部分状况。

能够用20%的标签完成80%的效果

基础markdown语法参考:https://www.appinn.com/markdown/

插入数学公式markdown语法参考:https://www.zybuluo.com/codeep/note/163962

相关文章
相关标签/搜索