学习Markdown
学习markdown
一、概述说明
Markdown 是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。[1]
目前markdown可以在多种网站上进行交互,例如cnblog、cdsn、github,这些网站都支持 markdown 格式。所以有其学习的必要性。
本文基于博客园展示效果来简述markdown的一些语法及其使用。
二、编辑器选择
为了更好的书写markdown格式的纯文本,本文推荐 widonws 平台下使用软件 markdownpad,下载地址:https://markdownpad.com/download.html。安装后可能遇到错误提示“HTML Render Error”,可通过安装插件 awesomium 来修复。[2]
三、语法介绍
语法糖:当一些格式无法实现时请借助 html 标签,基本可以搞定。
1、标题格式
标题格式是通过 "#"+空格 实现的。
一级标题: "# 一级标题 #" (两个空格)
一级标题: "## 二级标题 ##" (两个空格)
一级标题: "### 三级标题 ###" (两个空格)
当然,如果使用 MarkdownPad 编辑器,工具栏有内置的 H1 和 H2。
2、段落格式
段落换行
a、行尾添加两个以上空格加换行符实现。
b、用一个空行简单的将两段落隔开。
c、可以借助"<p></p>"标签实现。
段落缩进
段落缩进借助 html 标签实现
a、 来表示一个全角空格;
b、 表示一个半角空格。
c、 表示行中间的空格。
3、字体格式
a、斜体文本,*斜体文本*:斜体文本;
b、粗体文本,**粗体文本**:粗体文本;
c、粗斜体文本,***粗斜体文本***:粗斜体文本;
d、分割线,一行中用三个以上的星号、减号、底线来建立一个分隔线:
e、删除线,用s标签实现 <s>删除线</s>:删除线
f、文本居中,<center>居中文本</center>:
注意,在使用center后的文本独占一行。
g、脚注,首先要定义脚注: "[^LABEL]: ",在引用处使用[^LABEL]即可。上文中的[1]、[2]都是以此方法实现。
4、插入图片
a.借助 Markdown 提供的 alt 标签实现:![alt 属性文本](图片地址 "可选标题") 可选标题项可省略。
b.借助 html 提供的 <img> 标签实现: <img src="图片地址"></img>,可以添加 img 标签支持的样式及属性。
c.借助 html 提供的 <img> 标签和 <div> 标签实现图片居中。本文章节二中就是如此实现。
5、插入代码块
a.行内插入某个函数或这一行代码,用"`"括起来即可。`printf()`: printf()
b.一整块代码,可以在每行代码前加4个空格或1个tab。注意:起止行要与其他部分加空行隔开
#!/usr/bin/python
# -*- coding: utf-8 -*-
def main():
print('hello world')
main()
5、插入表格
在Markdown中,用 | 分割前后单元格,用-来分隔表头行和其他行。
<div class="center">
|表头|表头|表头|
|---|---|---|
|内瓤|内容|内容|
</div>
显示效果如下:
表头 | 表头 | 表头 |
---|---|---|
内瓤 | 内容 | 内容 |
在分割表头行和数据行时可以用 :--- 表示左对齐; :---:表示居中对齐; ---: 表示右对齐。
如果要实现整个表格的居中,可以在文档开头定义类选择器,设置好居中格式,然后将表格写入 div 标签,并为标签设置class属性。本文开头有全局的style,并且为表格设置了格式。此方法对于所有不可实现的格式都可用。甚至表格本身都可以用 table 标签实现。
<style>.center {
width: auto;
display: table;
margin-left: auto;
margin-right: auto;
}
</style>
6、插入区块
笔者理解这里的区块就类似文章标题的缩进,可以用">"加空格实现。
\> 1、概述说明
\> 2、编辑器选择
\> 3、语法介绍
\>
\> \> 3.1、标题格式
\> \> 3.2、段落格式
显示效果如下:
1、概述说明
2、编辑器选择
3、语法介绍3.1、标题格式
3.2、段落格式4、本篇博客效果
6、插入列表
无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记。
有序列表使用数字并加上 . 号来表示。
<div class="center">
* 星期一
* 星期二
* 星期三
1. 第一行
2. 第二行
3. 第三行
</div>
显示效果:
- 星期一
- 星期二
- 星期三
- 第一行
- 第二行
- 第三行
四、本篇博客效果
本文的文本效果可以参考博客园https://www.cnblogs.com/mengrui291/p/12807050.html
文本文档全内容可以参考https://github.com/liuzhenquan291/markdown/blob/master/Markdown%E5%AD%A6%E4%B9%A0(1).md
五、注意事项
如果使用了