碎言博客

Markdown 语法学习总结

J.sky 2017-08-25 08:55:15 网站运维

Markdown 的目标是实现「易读易写」。

需求

因为以后更新博客就需要和 Markdown 语法一直打交道了,所以有必要总结一下常用的Markdown语法,就当笔记记录一下,如有需要的时候翻查回忆一下。

解决方案

Markdown 语法的相关文档及教程在网上一搜一大把,这篇并不是 Markdown 的详细教程,只是笔者对以后博文更新常用的 Markdown 语法的一次学习及总结。

语法说明

### 标题

### 标题哈  
## 标题哈  
# 标题哈

标题哈

标题哈

标题哈

官方文档中的另一种标题写法

This is an H1
=============

This is an H2
-------------

这是标题 H1

是标题 H2

引用

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

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

序列

序列是文章中经常用到的,有几种写法如下:

* Python
+ Django
- Java
1. Python
2. Django
3. Java

Markdown 代码块

比较常用的有三种方式,最简单的就是下边这种方式,一般都是用来显示一些编程语言名称提示比如 Python Django

`这里是一小段代码哦`
这里是一小段代码哦

要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,显示一行或简单几行的代码时可以用这种方法

要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以

pre 和 code 可以直接上代码段,如果是大代码段推荐使用这种方法,如果引用了第三方的code样式,可以加上 class="你的编程语言",这样会更友好的显示。


<pre><code class="markdown">这里是一小段代码哦</code></pre>

这里是一小段代码哦

超链接

[17python]()
[百度](http://www.baidu.com)

17python

百度

强调

*Python*

_Django_

**Java**

__Spring Boot__

Python

Django

Java

Spring Boot

插入图片

![其实这不是站长的本人的照片](/media/upload/2017/08/avatar.jpg)

![17python 微信公众号,欢迎关注哦!](/media/upload/2017/08/wx.jpg "www.17python.com")

其实这不是站长的本人的照片

17python 微信公众号,欢迎关注哦!

如果需要控制图片大小的话,直接插入 html img 标签控制图片大小即可。 markdown 中是可以兼容html代码的哦!!!!

最后

<font color=red>Markdown 支持内嵌 HTML 标签。</font> Markdown 支持内嵌 HTML 标签。

参考: Markdown: Basics (快速入门)

发现错误?想参与编辑? 在 GitHub 上编辑此页!

如果您有什么问题,欢迎加入Python/Javascript学习讨论群询问

Python/Javascript学习QQ群号:217840699