2020-04-13

Python-Version

1. Python版本
 1.1 python --version
 1.2 Python 2 vs 3 comparison
 1.3 python 2 to 3 converter
2. Python 手册
 2.1 最新官方中文手册
 2.2 learn python
 2.3 Python 风格指南 - 内容目录
3. Python软件
 3.1 Python软件清单
 3.2 Python开发环境
 3.3 Python IDE对比
4. see also

1. Python版本

1.1 python --version

$ python --version
Python 3.8.2
https://en.wikipedia.org/wiki/History_of_Python#Table_of_versions

1.2 Python 2 vs 3 comparison

Comparison	Python 3	Python 2
最早发行版本	V3.0 2008	V2.0 2000
最新发行版	V3.8.2 2020	V2.7 2010, 2020已停止更新
print	print (“hello”)	print “hello”
整数除法 Division	得到浮点数	总是整数
Unicode 支持	字符串默认Unicode	要存储Unicode字符串，需使用”u”定义
语法 Syntax	语法简单易懂	语法相对难以理解
排序比较规则	简化了排序比较规则	非常复杂
迭代 Iteration	新的range()函数来执行迭代	xrange()用于迭代
例外情况	应将其括在括号中	包含在符号中
变量泄漏	变量的值永远不变	在for循环中使用全局变量时，其值会更改。
兼容 Compatibility	将python 2移植到python 3并不难，不过不太可靠	Python版本3与Python 2向后不兼容。
库 Library	越来越多...	很多已经不再更新，淘汰中...
不等运算符	!=	!= 和 <>
True, False	True, False 变为2个关键字。不允许重新赋值。修正了版本2的缺陷	True, False是2个全局变量，数值对应0,1; 变量可以指向其他对象: True = False
nonlocal	新增关键字 nonlcoal，使得非局部变量成为可能。

Comparison	Python 3	Python 2	备注
编码	>>> import sys >>> sys.getdefaultencoding() 'utf-8' # 默认使用 utf-8, 所以如下是合法的 >>> 中国 = 'china' >>>print(中国) china	>>> import sys >>> sys.getdefaultencoding() 'ascii' # 默认ascii, 代码顶部包含 # coding=utf-8 >>> str = u"中国" >>> str u'\u4e2d\u56fd'	>>> import sys >>> sys.getdefaultencoding() 'ascii' >>> reload(sys) <module 'sys' (built-in)> >>> sys.setdefaultencoding("utf-8") >>> sys.getdefaultencoding() 'utf-8'
字符串	str, 字符串；byte, 字节序列。任何需要写入文本或者网络传输的数据都只接收字节序列，这就从源头上阻止了编码错误的问题。	unicode, 文本字符串；srt, 字节序列。不过两者并没有明显的界限	=转换= ; =作用=
=字节=	byte	str	encode ; 存储, 传输
=字符=	str	unicode	decode ; 展示

reference:
https://www.guru99.com/python-2-vs-python-3.html#7

Python2.x与3.x版本区别:
https://www.runoob.com/python/python-2x-3x.html
Python的3.0版本，常被称为Python 3000，或简称Py3k。相对于Python的早期版本，这是一个较大的升级。为了不带入过多的累赘，Python 3.0在设计的时候没有考虑向下相容。

Python 2 和 Python 3 有哪些主要区别？
https://www.zhihu.com/question/19698598

1.3 python 2 to 3 converter

2to3 - Automated Python 2 to 3 code translation
https://docs.python.org/2/library/2to3.html

2to3 - 自动将 Python 2 代码转为 Python 3 代码
https://docs.python.org/zh-cn/3/library/2to3.html

https://www.pythonconverter.com/

2. Python 手册

2.2 learn python

https://www.learnpython.org/
https://www.techbeamers.com/python-tutorial-step-by-step/

2.3 Python 风格指南 - 内容目录

https://zh-google-styleguide.readthedocs.io/en/latest/google-python-styleguide/contents/
https://github.com/zh-google-styleguide/zh-google-styleguide/tree/master/google-python-styleguide
https://github.com/google/styleguide
https://google.github.io/styleguide/pyguide.html

3. Python软件

3.1 Python软件清单

https://en.wikipedia.org/wiki/List_of_Python_software

3.2 Python开发环境

https://en.wikipedia.org/wiki/Python_(programming_language)#Development_environments
https://zh.wikipedia.org/wiki/Python#开发环境

3.3 Python IDE对比

https://en.wikipedia.org/wiki/Comparison_of_integrated_development_environments#Python

IDE 跨平台

Written in

小部件工具包

License

Python2x支持

Python3x支持

Debugger

GUI生成器

集成工具链

探查器

代码覆盖率

自动完成

静态程序分析

基于GUI的设计

类浏览器

代码重构

版本控制系统支持

Web框架支持

IDLE

Python

Tkinter

PSFL

Yes

Unknown

Yes

Unknown

eric

Python

PyQt

GPLv3 "or later"

Yes

Yes: Qt

Unknown

Yes

Pylint via

Yes

Git, Mercurial, SVN

Django plug-in

PyCharm

Java

Swing

Apache License 2.0

Yes

Unknown

Yes

Yes .

Yes

Yes .

Yes

PyDev / LiClipse

Unknown

SWT

EPL

Yes

Unknown

Yes

Unknown

Yes

Unknown

Visual Studio Code

JavaScript

HTML

MIT License

Yes

Unknown

Yes

Unknown

Yes

Unknown

Yes

Spyder

Python

PyQt, PySide

MIT License

Yes 2.7

Yes

Unknown

Beta

Planned

Partial

Thonny

Python

Tkinter

MIT License

Yes

Unknown

Yes

Flask

Wing

Python

Qt5 with PyQt

Proprietary

Yes

Yes .

Yes

KDevelop

C, C++

GPL

Unknown

Yes

Unknown

Yes

Unknown

Yes

Git, Mercurial, SVN
Bazaar, CVS

Unknown

Geany

GTK+

GPL

Unknown

Yes

Unknown

Yes

Unknown

2020-04-09

python-class01

[TOC]

# 1 类与对象概念
- 类(Class): 用来描述具有相同的属性和方法的对象的集合。它定义了该集合中每个对象所共有的属性和方法。对象是类的实例。
- 类变量：类变量在整个实例化的对象中是公用的。类变量定义在类中且在函数体之外。类变量通常不作为实例变量使用。
- 数据成员：类变量或者实例变量, 用于处理类及其实例对象的相关的数据。
- 方法重写：如果从父类继承的方法不能满足子类的需求，可以对其进行改写，这个过程叫方法的覆盖（override），也称为方法的重写。
- 局部变量：定义在方法中的变量，只作用于当前实例的类。
- 实例变量：在类的声明中，属性是用变量来表示的。这种变量就称为实例变量，是在类声明的内部但是在类的其他成员方法之外声明的。
- 继承：即一个派生类（derived class）继承基类（base class）的字段和方法。继承也允许把一个派生类的对象作为一个基类对象对待。例如，有这样一个设计：一个Dog类型的对象派生自Animal类，这是模拟"是一个（is-a）"关系（例图，Dog是一个Animal）。
- 实例化：创建一个类的实例，类的具体对象。
- 方法：类中定义的函数。
- 对象：通过类定义的数据结构实例。对象包括两个数据成员（类变量和实例变量）和方法。

基本语法
# 2 class
https://docs.python.org/zh-cn/3/tutorial/classes.html
https://www.runoob.com/python/python-object.html

```
#!/usr/bin/python
# -*- coding: UTF-8 -*-

class MyClass: # [1. 定义类]，大写字母开头 __name__
'描述文本' # 描述文本， __doc__
i = 123 # 定义类的变量，小写字母开头
myCount = 0
def __init__(self, name, page):
self.name = name
self.page = page
MyClass.myCount += 1
def displayCount(self):
print ("Total myCount: ", MyClass.myCount)
def displayName(self):
print ("name: ", self.name, ", page: ", self.page)
def f(self): # 定义类的方法，小写字母开头
return ('hi py!')
def prt(self):
print (self)
print (self.__class__)

print ("-----内置类属性-----------") # [2. 内置类属性]
print ("MyClass.__doc__: ", MyClass.__doc__)
print ("MyClass.__name__: ", MyClass.__name__) # 实例没有这个属性
print ("MyClass.__module__: ", MyClass.__module__)
print ("MyClass.__bases__: ", MyClass.__bases__) # 实例没有这个属性
print ("MyClass.__dict__: ", MyClass.__dict__)
print ("MyClass.__class__: ", MyClass.__class__)
print ("--------分-割-线--------\n")

x1 = MyClass("python",100) # [3. 创建类的实例对象]
print ("访问属性:", x1.i) # [4. 访问属性]，打印实例x1的属性
print ("访问方法:", x1.f()) # 打印实例x1的f方法
print ("total myCount %d" % MyClass.myCount)
print ("--------分-割-线--------\n")

print ('==== x1.prt begin====')
x1.prt()
print ('==== x1.prt end====')
print ("--------分-割-线--------\n")

x1.displayCount()
x1.displayName()
print ("--------分-割-线--------\n")

print ("----内置属性----") # [5. 内置属性]
print (x1.__doc__)
print (x1.__module__) # __main__
print (x1.__dict__) # {}
print (x1.__class__) # <class '__main__.MyClass'>
print ("--------分-割-线--------\n")

x2 = x1 # [6. ]
print ('x2 = x1')
print ('x1.displayCount():')
x1.displayCount() # myCound = 1;
print ('x2.displayCount():')
x2.displayCount() # myCound = 1;
print ("MyClass.myCount %d" % MyClass.myCount) # myCound = 1;
print ("--------分-割-线--------\n")

x3 = MyClass("python2",200) # [3. 创建类的实例对象]
print ('x3 = MyClass("python2",200)')
print ('x1.displayCount():')
x1.displayCount() # myCound = 2;
print ('x3.displayCount():')
x3.displayCount() # myCound = 2;
print ("MyClass.myCount %d" % MyClass.myCount) # myCound = 2;
print ("--------分-割-线--------\n")

print (id(x1), id(x2), id(x3)) # 打印对象的id
del x1 # [7. 销毁实例]，回收资源
del x2
del x3
print ('x1,x2,x3已销毁')
print ("销毁后，继续使用实例x1，就会报错: NameError: name 'x1' is not defined")
```
# 3 执行结果
```
> python py01.py
-----内置类属性-----------
MyClass.__doc__: 描述文本
MyClass.__name__: MyClass
MyClass.__module__: __main__
MyClass.__bases__: (<class 'object'>,)
MyClass.__dict__: {'__module__': '__main__', '__doc__': '描述文本', 'i': 123, 'myCount': 0, '__init__': <function MyClass.__init__ at 0x7f499f92df70>, 'displayCount': <function MyClass.displayCount at 0x7f499f95f040>, 'displayName': <function MyClass.displayName at 0x7f499f95f0d0>, 'f': <function MyClass.f at 0x7f499f95f160>, 'prt': <function MyClass.prt at 0x7f499f95f1f0>, '__dict__': <attribute '__dict__' of 'MyClass' objects>, '__weakref__': <attribute '__weakref__' of 'MyClass' objects>}
MyClass.__class__: <class 'type'>
--------分-割-线--------

访问属性: 123
访问方法: hi py!
total myCount 1
--------分-割-线--------

==== x1.prt begin====
<__main__.MyClass object at 0x7f499f9a3490>
<class '__main__.MyClass'>
==== x1.prt end====
--------分-割-线--------

Total myCount: 1
name: python , page: 100
--------分-割-线--------

----内置属性----
描述文本
__main__
{'name': 'python', 'page': 100}
<class '__main__.MyClass'>
--------分-割-线--------

x2 = x1
x1.displayCount():
Total myCount: 1
x2.displayCount():
Total myCount: 1
MyClass.myCount 1
--------分-割-线--------

x3 = MyClass("python2",200)
x1.displayCount():
Total myCount: 2
x3.displayCount():
Total myCount: 2
MyClass.myCount 2
--------分-割-线--------

139954187023504 139954187023504 139954187023744
x1,x2,x3已销毁
销毁后，继续使用实例x1，就会报错: NameError: name 'x1' is not defined
```

2020-04-08

python-note-001

[TOC]

1. 输入和输出
 1.1 print()
 1.2 input()
2. 变量和赋值
 2.1 变量的命名规范
 2.2 查看python的关键字
3. 条件判断
4. 常见的数据类型
 4.1 浮点数的运算误差
5. 数据的操作
 5.1 字符串的拼接
 5.2 四则运算
 5.3 数据转换
 5.4 type(),查询数据类型
 5.5 list列表语法
 5.6 dict字典语法
 5.7 bool()
6. 循环
 6.1 for循环
 6.2 while循环
 6.3 循环进阶
 6.4 补充: Python风格规范

1. 输入和输出

1.1 print()

打印括号里的内容
- 无引号，打印数字，计算机阅读并理解括号里的内容，打印结果（数字间若有计算符号，会输出计算结果）；`` print(1+1) ``
- 单/双引号，打印字符串，计算机不管引号中的内容（原样输出）；
``print("Let's go")`` ``print('Let\'s go') ``
- 三引号，打印段落（原样输出）；
同html的``<pre>多行文本</pre>``标签

**单/双引号里适当使用 \n 换行，可实现与三引号相同效果；**

转义字符列表
| 转义字符 | 意义 |
|

1.2 input()

收集从键盘输入的信息:
```
name = input('请输入你的 ID: ')
print(str(input('pls input\n')))
```
**input()函数的输入值永远会被【强制性】地转换为【字符串】类型。(Python3固定规则)**

2. 变量和赋值

```
name='xxx'
print(name)
xxx
```
- = **是赋值符号，将右边的内容赋值给左边的变量；**
- == **是比较运算符号，表示两边相等；**

2.1 变量的命名规范

1. 只能是一个词；
2. 只能包含字母，数字和下划线；
3. 不能以数字开头；
4. 尽量描述包含的数据内容；
5. 不要使用Python函数名或关键字；
- number = 34
- name = 'forchange'
- list_class = ['基础语法课程','爬虫分析初阶','爬虫分析进阶','自动化办公']
_以上number，name，list_class都是是变量名_

2.2 查看python的关键字

```
import keyword
keyword.kwlist
['False', 'None', 'True', 'and', 'as', 'assert', 'async', 'await', 'break', 'class', 'continue', 'def', 'del', 'elif', 'else', 'except', 'finally', 'for', 'from', 'global', 'if', 'import', 'in', 'is', 'lambda', 'nonlocal', 'not', 'or', 'pass', 'raise', 'return', 'try', 'while', 'with', 'yield']
```
False, None, True, and, or, not, def, del, import,
if, elif, else, for, while, break, continue, return, pass, try, except,
as, in, is, from, with,
assert, async, await, class, finally, global, lambda, nonlocal, raise, yield

判断是否为关键字:
```
keyword.iskeyword('false')
False
keyword.iskeyword('False')
True
```

3. 条件判断

- if [条件0] : (缩进的内容) \\ 单向判断
- if [条件0] : (缩进的内容) else: (缩进的内容) \\ 双向判断
- if [条件0] : (缩进的内容) elif [条件1] : (缩进的内容) else: (缩进的内容) \\ 多向判断
对于Python而言，冒号和缩进是一种语法。它会帮助Python区分代码之间的层次，理解条件执行的逻辑及先后顺序。
【注：缩进是四个空格或一个Tab键】
**IndentationError: expected an indented block(缩进错误：期望一个缩进块)**

if嵌套，就是在上面任何一个(缩进的内容)中添加一个if结构

4. 常见的数据类型

- srt string字符串, 用引号括起来的文本;
- int integer整数, 不带小数点的数字;
- float 浮点数, 带小数点的数字，运算结果存在误差;
- bool 布尔值, True or False;
- dice dictionary字典, 使用键值对(key-value)作为存储方式. 标识是大括号{};
- list 列表, 有序的集合，可以随时添加或删除其中的元素. 标识是中括号[];
- tuple 元组, 类似列表的数据类型，但是不能被修改。

4.1 浮点数的运算误差

```
print(0.55+0.3)
0.8500000000000001
```
为什么不是【0.85】，而尾巴多了一个【1】呢？这是因为，Python计算浮点数时，会先把0.55和0.3转化成二进制数. **[注：二进制数由0和1表示，逢二进一]**，如下:

进制转换:
```
0.55(十进制) = 0.1000110011001100110011001100110011001100110011001101(二进制)
0.3 (十进制) = 0.0100110011001100110011001100110011001100110011001101(二进制)
```
而在这个转化过程中存在误差，这样，就造成了我们与程序计算结果的差异。

5. 数据的操作

5.1 字符串的拼接

- '+' print(hero+action+organization+identity+ID) //字符串拼接, 不是字符串需要转换为字符串
- '%' print ('print%dnam%s'%(number,name)) ///不同类型的拼接

5.2 四则运算

- +
- -
- *
- /
- % 取模-返回除法的余数；5%2，返回1
- // 取整除-返回商的整数部分；5//2, 返回2
- ** 幂-返回x的y次幂；2**3, 2的3次方

**与平时运算优先级一样：从左到右顺着来，括号里的优先算，乘除排在加减前。**

5.3 数据转换

- str() 强制转换为字符串
- int() 将整数形式的字符串转换为整数，(文本和浮点数不能转换为整数)
- print(int(3.3)) 浮点数直接抹零取整数
- float() 将整数和数字形式的字符串转换为浮点数，(文字类字符串无法转转)
- list() 将数据转换为列表类型
```
>>> name = 'python'
>>> print(list(name))
['p', 'y', 't', 'h', 'o', 'n']
```
- len() 返回数据长度
```
>>> namelist=list(name)
>>> list2= ['py','th','on']
>>> len(name)
6
>>> len(namelist)
6
>>> len(list2)
3
```

5.4 type(),查询数据类型

```
print(type(who))
<class 'str'>
```

5.5 list列表语法

- 偏移量: 列表元素的位置编号, 从0开始
- 对列表元素的处理: 增, 删, 改, 查(提取)
- 提取: list[0] 取出位置0的元素; list[a:b] 取出位置a到b, 但不包括b的所有元素(a<=X小于b); list[:]全部;
- 修改: list[0]='tree0'
- 增加: list.append('tree3') 添加到列表末尾，注意append()函数后面是小括号,不是方括号
- 删除: del list[0]
- 对列表的处理: 增, 删, 改, 查(提取)
- 提取: list[1:2] 列表的切片(子列表, 列表片段)，一次提取多个元素
- 删除: del list[1:2] 删除切片(子列表, 列表片段)，一次删除多个元素
- 增加(合并): list = list1 + list2 列表的合并
- 修改(赋值): list = ['0','1','2']; list[:] = ['xx'] 对列表赋值
- 嵌套列表的提取
```
>>> list = [['0','0a'],['1','1b'],['2','2c']]
>>> print(list[0][1])
0a
```

5.6 dict字典语法

group={'k1':'v1','k2':'v2','k3':'k3'}
- 增加: group['k4']=v4 ;
- 删除: del group['k4'] ;
- 修改: group['k1']=v11 ;
- 提取: group['k1'] 取出v1 ; 列表使用偏移量来提取，字典使用键来提取
- dict.deys() 提取字典中所有键
- group.keys() 元组的形式
- list(group.keys()) 将元组转换为列表
- dict.valus() 提取字典中所有的值
- group.values()
- dict.items() 提取字典中所有键值对
- group.items()

5.7 bool()

检查数值的真假
```
>>> print(bool(1))
True
```
值本身作为条件

| Type | 假值 | 其他都是真值 |
| ------ | ----- | ---------------- |
| bool | False | True |
| number | 0 | 非0数值(int, fl) |
| srt | '’ | 非空字符串 |
| list | [] | 非空列表 |
| dict | {} | 非空字典 |
| | None | |

比较运算符产生布尔值

| 运算符 | 释义 |
| ------ | -------- |
| '== | 等于 |
| != | 不等于 |
| > | 大于 |
| < | 小于 |
| >= | 大于等于 |
| <= | 小于等于 |

**运算符之间不用空格，不可以写成= =、> =**

成员运算符产生布尔值

| 运算符 | 释义 |
| ------ | ------ |
| in | 属于 |
| not in | 不属于 |

逻辑运算符产生布尔值

| 运算符 | 释义 |
| ------ | ---- |
| and | 与 |
| or | 或 |
| not | 非 |

6. 循环

6.1 for循环

for 条件 : (缩进的内容)

- 遍历字符串
```
# py01.py文件内容:
for i in 'code':
print(i)
# bash下执行:
> python py01.py
c
o
d
e
```

- 遍历列表
```
# py01.py文件内容:
for i in ['code','py']:
print(i)
# bash下执行:
> python py01.py
code
py
```
- 遍历字典的键
```
# py01.py文件内容:
list = {1:'a',2:'b',3:'c'}
for i in list:
print(i)
# bash下执行:
> python py01.py
1
2
3
```

- 遍历字典的值
```
# py01.py文件内容:
list = {1:'a',2:'b',3:'c'}
for i in list.values():
print(i)
# bash下执行:
> python py01.py
a
b
c
```

- 遍历字典的键值对
```
# py01.py文件内容:
list = {1:'a',2:'b',3:'c'}
for k, v in list.items():
print(k)
print(v)
# bash下执行:
> python py01.py
1
a
2
b
3
c
```

### range()函数
range()有最基本的三种用法：range(a)， range(a,b)，range(a,b,c)。
* a：计数从a开始。不填时，从0开始；b：计数到b结束，但不包括b；c：计数的间隔，不填时默认为1。
```
range(5)
# 计数依次为0，1，2，3，4
range(1,5)
# 计数依次为1，2，3，4
range(2,8,2)
# 计数依次为2，4，6
```

### for…in range()
处理指定次数的循环
```
for i in range(3):
print('第%d行' %i)
```

6.2 while循环

只要条件为真，便会一直循环
```
count = 3
while count > 1:
print('happy coding')
count = count -1
happy coding
happy coding
```
while循环和for循环的区别:
- for擅长处理固定次，自动遍历各序列
- while处理不定次数的循环，条件为False便停止

6.3 循环进阶

- continue, 跳过当前循环的剩余语句, 直接开始下一轮循环
- else, 无论是否进入循环, 最后都会执行esle语句, 除非执行break语句跳出循环
```
while True:
print('happy coding')
break
```
循环嵌套
```
>for i in ['qw','ert']: #首先遍历列表元素
... for t in i: #然后遍历元素(字符串)
... print(t)
```

6.4 补充: Python风格规范

- break, 结束循环
Docs » Python 风格指南 - 内容目录 » Python风格规范

https://zh-google-styleguide.readthedocs.io/en/latest/google-python-styleguide/python_style_rules/

Atom-markdown

# 1 Atom markdown
## 1.1 markdown-preview
https://atom.io/packages/markdown-preview
Markdown预览
- Edit \ preferences \ Packages \ markdown-preview
- 默认已打开的
- Packages \ Markdown Preview \ Toggle Github Style
- 切换为Github风格
- Edit \ Stylesheet...
- 编辑styles.less样式表

> .markdown-preview.markdown-preview {
> background-color: #fff;
> }
- markdown-preview 页面右键单击预览的任何空白区域
- 单击“Save As HTML” ...获得html文件。

## 1.2 增强预览(markdown-preview-plus)

https://atom.io/packages/markdown-preview-plus
https://github.com/atom-community/markdown-preview-plus/blob/master/docs/installation.md
- Edit \ preferences \ Install \ 搜索: markdown preview plus
- Install 安装插件
- Edit \ preferences \ Packages \ markdown-preview
- Atom已自动关闭了markdown-preview，若没有，可以在这里手动关闭

Atom自带的Markdown预览插件markdown-preview功能比较简单，markdown-preview-plus对其做了功能扩展和增强。
1. 支持预览实时渲染。(Ctrl + Shift + M)
2. 支持Latex公式。(Ctrl + Shift + X)
3. (可选)在引用支持下使用pandoc(通用文档转换器)

https://pandoc.org/
> $ sudo pacman -S pandoc

(← = conversion from; → = conversion to; ↔︎ = conversion from and to)

- Word processor formats

- ↔︎ Microsoft Word docx
- ↔︎ OpenOffice/LibreOffice ODT
- → OpenDocument XML
- → Microsoft PowerPoint
- HTML formats
- ↔︎ (X)HTML 4
- ↔︎ HTML5
- Ebooks
- ↔︎ EPUB version 2 or 3
- ↔︎ FictionBook2
- Data formats
- ← CSV tables
- PDF
- → via pdflatex, xelatex, lualatex, pdfroff, wkhtml2pdf, prince, or weasyprint.
- Lightweight markup formats
- ↔︎ Markdown (including CommonMark and GitHub-flavored Markdown)
- ... 还有更多，请参阅官网

# 2 更多软件包
1. 同步滚动(markdown-scroll-sync)
- https://atom.io/packages/markdown-scroll-sync
2. 代码增强(language-markdown)
- https://atom.io/packages/language-markdown
- 添加了对Markdown的语法支持(including Github flavored, AtomDoc, Markdown Extra, CriticMark, YAML/TOML front-matter, and R Markdown)，以及列表中的智能上下文感知行为和内联重点的键盘快捷键。
3. 图片粘贴(markdown-image-paste)
- https://atom.io/packages/markdown-image-paste
1. 截图或复制图片到系统剪切板。
2. 在Markdown新起一行输入文件名。
3. 点击ctrl + v将图像粘贴到markdown或rst文件中
- 默认保存到Markdown文件相同目录下(因此要求Markdown文件应该先保存)。
- (如果找不到图片),从新输入文件名，英文的无空格文本
4. 表格编辑(markdown-table-editor)
- https://atom.io/packages/markdown-table-editor
- ![markdown-table-editor](https://i.github-camo.com/c2a810dc038c3fb1a3d3373fc6ae83c51112997f/68747470733a2f2f6769746875622e636f6d2f7375736973752f6d61726b646f776e2d7461626c652d656469746f722f77696b692f696d616765732f64656d6f2e676966)

      | Name          | Description               | Keybinding  |
      | ------------- | ------------------------- | ----------- |
      | Next Cell     | Move to the next Cell     | tab         |
      | Previous Cell | Move to the previous cell | shift + tab |
      | Next Row      | Move to the next row      | enter       |
      | Escape        | Escape from table         | ESC         |

5. pdf导出(markdown-themeable-pdf、pdf-view), 比上面的pandoc轻便些，可以试试。
6. 格式化JSON(pretty-json)
- https://atom.io/packages/pretty-json
- ![pretty-json](https://i.github-camo.com/df2969f63f4141f94d94d6f5ab71b3a4266811b5/687474703a2f2f692e696d6775722e636f6d2f4e6434477674502e676966)

7. 格式化(atom-beautify)
- https://atom.io/packages/atom-beautify
- Beautify HTML, CSS, JavaScript, PHP, Python, Ruby, Java, C, C++, C#, Objective-C, CoffeeScript, TypeScript, Coldfusion, SQL, and more in Atom
8. 更多软件包，可以在官网查看，首页有[当天/本周/本月]最受欢迎的排行，看看有没有你需要的。
- https://atom.io/packages
- markdown-preview-enhanced.语法高亮，双向实时预览。(推荐)
- https://atom.io/packages/markdown-preview-enhanced
- markdown-toc,markdown目录生成插件
- https://atom.io/packages/markdown-toc
- markdown-writer，markdown编辑器插件
- https://atom.io/packages/markdown-writer
- apm install file-icons 图标
- https://atom.io/packages/file-icons

# 3 参考阅读
如何设置和使用Atom作为Markdown编辑器
https://www.portent.com/blog/copywriting/content-strategy/atom-markdown.htm

使用Atom打造无懈可击的Markdown编辑器
https://www.cnblogs.com/fanzhidongyzby/p/6637084.html

2020-04-06

Python

Python 基础语法

2020-04-01

Markdown

# 1. Markdown {1}

https://en.wikipedia.org/wiki/Markdown
https://zh.wikipedia.org/wiki/Markdown
Markdown是一种轻量级标记语言，创始人为约翰·格鲁伯（英语：John Gruber）。它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
由于Markdown的轻量化、易读易写特性，并且对于图片，图表、数学式都有支持，当前许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等，甚至还能被使用来撰写电子书。

# 2. 标准化 {2}

## 2.1 CommonMark {2.1}

从2012年开始，包括Jeff Atwood和John MacFarlane在内的一群人启动了标准化工作, 更名为CommonMark. http://spec.commonmark.org/

## 2.2 GFM {2.2}

2017年，GitHub发布了基于CommonMark的GitHub Flavored Markdown（GFM）的正式规范。除了表格、删除线、自动链接和任务列表被GitHub规范作为扩展添加之外，它遵循CommonMark规范。GitHub还相应地更改了其站点上使用的解析器，这要求更改某些文档 - 例如，GFM现在要求创建标题的哈希符号由空格字符分隔。
- https://github.github.com/gfm/
- https://help.github.com/en/github/writing-on-github
- https://help.github.com/cn/github/writing-on-github

## 2.3 Markdown Extra {2.3}

Markdown Extra是一种轻量级标记语言，基于在PHP(最初),Python和Ruby中实现的Markdown。它添加了普通Markdown语法不具备的功能。
内容管理系统支持Markdown Extra，例如Drupal, TYPO3, MediaWiki。
它为Markdown添加了以下功能: HTML块内的markdown标记; 具有id / class属性的元素; 围栏代码块; 表格; 定义清单; 脚注; 缩写;

# 3. Markdown使用 {3}
## 3.1 Markdown 入门 {3.1}
https://markdown.bootcss.com/getting-started/
Markdown 语法的首要设计目标是尽可能易读。基于这个目标，Markdown 格式的文档能够以纯文本形式原样发布，而不会看起来像被填满了标签或格式化指令。

## 3.2 Markdown语法 {3.2}
[Markdown 速查表](https://markdown.bootcss.com/cheat-sheet/)
Markdown 速查表提供了所有 Markdown 语法元素的快速参考。但是此速查表无法覆盖所有用法，因此，如果你需要某些语法元素的更多信息，请参阅我们的: [基本语法](https://markdown.bootcss.com/basic-syntax/); [扩展语法](https://markdown.bootcss.com/extended-syntax/)

## 3.3 推荐的一些Markdown文档创作应用程序: {3.3}
https://markdown.bootcss.com/getting-started/#documents
- Mac: MacDown, iA Writer, or Marked
- iOS / Android: iA Writer
- Windows: ghostwriter or Markdown Monster
- Linux: ReText or ghostwriter
- https://wiki.archlinux.org/index.php/List_of_applications/Documents#Markdown
- https://wiki.gentoo.org/wiki/ReText
- https://github.com/retext-project/retext
- Web: Dillinger or StackEdit
- https://dillinger.io/
- https://markdown.bootcss.com/tools/stackedit/

## 3.4 Markdown 相关工具 {3.4}
https://markdown.bootcss.com/tools/
支持 Markdown 的应用程序和组件。下表
| name | 中文描述 | 英文描述 |
| :-----------: | :----------- | :----------- |
| Bear | Bear是适用于macOS和iOS设备的Markdown笔记应用程序。 | Bear is a Markdown notes application for macOS and iOS devices. |

name	中文描述	英文描述
Bear	Bear是适用于macOS和iOS设备的Markdown笔记应用程序。	Bear is a Markdown notes application for macOS and iOS devices.
Boostnote	Boostnote是面向开发人员的Markdown笔记应用程序。	Boostnote is a Markdown note taking application for developers.
CodiMD	CodiMD是一个开源的实时协作Markdown编辑器。	CodiMD is an open-source real-time collaborative Markdown editor.
Dillinger	Dillinger是专为移动写作而设计的在线Markdown编辑器。	Dillinger is an online Markdown editor designed for on-the-go writing.
Docusaurus	Docusaurus将Markdown文件转换为文档网站。	Docusaurus converts Markdown files to a documentation website.
Ghost	Ghost是一个开源CMS，以其速度，简单性和易用性而闻名。	Ghost is an open source CMS renowned for its speed, simplicity, and ease of use.
GitBook	GitBook是文档网站和知识库的托管解决方案。	GitBook is a hosted solution for documentation websites and knowledge bases.
GitHub Pages	GitHub Pages是一项免费服务，可将Markdown文件转换为网站。	GitHub Pages is a free service that turns Markdown files into a website.
Hugo	Hugo是一个静态网站生成器，可将Markdown文件转换为网站。	Hugo is a static site generator that converts Markdown files to a website.
iA Writer	iA Writer是最著名的Markdown编辑器之一。	iA Writer is one of the most established and widely-acclaimed Markdown editors.
Imdone	Imdone是基于markdown的看板，位于注释，文档和代码中。	Imdone is a markdown based kanban board, that lives in your notes, docs, and code.
Jekyll	Jekyll是一个静态网站生成器，可将Markdown文件转换为网站。	Jekyll is a static site generator that converts Markdown files to a website.
Joplin	乔普林（Joplin）是一个记笔记应用程序，它尊重您的隐私。	Joplin is a note taking application that respects your privacy.
MacDown	MacDown是可用于macOS的最佳Markdown编辑器之一。	MacDown is one of the best Markdown editors available for macOS.
Mark Text	Mark Text是专为Markdown设计的流行的免费开放源代码编辑器。	Mark Text is a popular free and open-source editor designed for Markdown.
Markdeep	Markdeep会将任何Markdown文件转换为独立的HTML文件。	Markdeep turns any Markdown file into a self-contained HTML file.
Markdown Here	Markdown这是一个浏览器扩展程序，可以转换Web表单中的Markdown文本。	Markdown Here is a browser extension that converts Markdown text in web forms.
Mattermost	Mattermost是一个开源消息传递和团队协作应用程序。	Mattermost is an open source messaging and team collaboration application.
MkDocs	MkDocs是用于构建文档网站的静态网站生成器。	MkDocs is a static site generator for building documentation websites.
Notable	值得注意的是带有Markdown支持的准系统笔记应用程序。	Notable is a bare-bones note taking application with great Markdown support.
Notion	概念是针对所有人的多合一知识管理解决方案。	Notion is an all-in-one knowledge management solution for everyone.
Reddit	Reddit是一个受欢迎的在线社区，支持在Markdown中发布。	Reddit is a popular online community that supports posting in Markdown.
Simplenote	Simplenote是跨平台的Markdown笔记应用程序。	Simplenote is a cross-platform Markdown notes application.
Slack	Slack是一个消息传递和团队协作应用程序。	Slack is a messaging and team collaboration application.
Squarespace	Squarespace是用于构建网站的流行订阅服务。	Squarespace is a popular subscription service for building websites.
StackEdit	StackEdit是功能强大的在线Markdown编辑器，您可以在任何地方使用。	StackEdit is a powerful online Markdown editor you can use anywhere.
Standard Notes	Standard Notes是一种优雅的开源笔记记录应用程序。	Standard Notes is an elegant, open-source note taking application.
Trello	Trello是一个看板风格的项目管理应用程序。	Trello is a kanban-style project management application.
Typora	Typora是一种用于便笺和文档的简单且可配置的编辑器。	Typora is a simple and configurable editor designed for notes and documents.
Ulysses	Ulysses是适用于macOS和iOS设备的流行编写应用程序。	Ulysses is a popular writing application for macOS and iOS devices.

## 3.5 Markdown 更多教程 {3.5}
https://www.runoob.com/markdown/md-tutorial.html
本教程将使用 Typora 编辑器来讲解 Markdown 的语法，Typora 支持 MacOS 、Windows、Linux 平台，且包含多种主题，编辑后直接渲染出效果。
支持导出HTML、PDF、Word、图片等多种类型文件。
Typora 官网：https://typora.io/
你也可以使用我们的在线编辑器来测试: https://c.runoob.com/front-end/712

https://www.markdownguide.org/
https://github.com/showdownjs/showdown
http://demo.showdownjs.com/

## 3.6 cnblogs支持markdown {3.6}
https://www.cnblogs.com/cmt/p/markdown.html
更新：2014年7月22日发布了新版markdown功能，详见新版markdown功能发布！支持github flavored markdown！
https://www.cnblogs.com/cmt/p/markdown_github.html
markdown语法：Markdown Cheatsheet
https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet

## 3.7 小结 {3.7}
Markdown相对html等标记语言，确是简洁，但简单了解下来也仅适合书写简单的介绍，没有表格，目录的短文。
扩展语法里有表格，也可以这是左右对齐等；也有标题的ids，但是使用起来反而不如html方便啊。
对这种轻量级的语言也仅适合轻量级的应用。github使用pages页面，就是个介绍页面。
在没有表格，不需要目录的情况下，还是很方便的。Linux下很多图形化的文档编辑器都支持md格式，就是说默认情况下保存问*.md文件，就能在写文档的同时清晰的看到标题，列表等,使用默认的颜色区分来开。

# 4. See Also {4}
选择正确的Markdown解析器
https://css-tricks.com/choosing-right-markdown-parser/
如果您要选择要使用的版本（或您要在网络产品上提供给用户的版本），则必须了解要使用的版本，因为一旦选择并有内容就很难切换那里取决于那些功能。
https://github.com/markdown/markdown.github.com/wiki/Implementations

What are the main rendering differences between Markdown and CommonMark?
https://help.apiary.io/faq/commonmark/

https://en.wikipedia.org/wiki/List_of_document_markup_languages
https://zh.wikipedia.org/wiki/文档标记语言比较
https://en.wikipedia.org/wiki/Comparison_of_document-markup_languages
https://en.wikipedia.org/wiki/Lightweight_markup_language
https://en.wikipedia.org/wiki/Lightweight_markup_language#Comparison_of_lightweight_markup_language_syntax
https://en.wikipedia.org/wiki/Lightweight_programming_language
https://en.wikipedia.org/wiki/Lightweight_software
https://en.wikipedia.org/wiki/Wiki_markup
https://en.wikipedia.org/wiki/Help:Wikitext

https://sspai.com/post/55786
个人博客的方案推荐，你只负责编写
docsify 是一个动态生成文档网站的工具。不同于 GitBook、Hexo 的地方是它不会生成将 .md 转成 .html 文件，所有转换工作都是在运行时进行。这将非常实用，如果只是需要快速的搭建一个小型的文档网站，或者不想因为生成的一堆 .html 文件「污染」commit 记录，只需要创建一个 index.html 就可以开始写文档而且直接部署在 GitHub Pages。
https://docsify.js.org/#/zh-cn/themes
https://cdn.jsdelivr.net/npm/docsify/lib/themes/dark.css

10分钟让你的站点也支持Markdown
https://blog.csdn.net/github_36700243/article/details/62430414
https://github.com/showdownjs/showdown

订阅：博文 (Atom)