欢迎使用Markdown编辑器写博客
hjjnote: 上面是一号标题
hjjnote:这是我学习markdown 的地方,过几天就删除该文档
hjjnote:
关于markdown 文本编辑格式,
markdown 是把无格式文本加上了若干标示的文本.
markdown 的显示格式由渲染环境根据它的CSS环境来渲染,例如多个空格为一个空格,首行无空格,多个tab为一个tab, 多个回车为一个回车.
这样的渲染格式也常常让初学者感到迷惑, 我文本书写中是有对齐格式的,但渲染环境没有表现出来.这个我们慢慢来解决.因为它认为,文本排版不需要我们书写者操心! 我们姑且认为它的提法是对的.
现在我们来看看它的一些语法特性:
它认为: 段落是由一个单独的回车来分割的,这个我们容易接受.
它认为: 段落并不需要首行缩进2个字符,这个与我们传统的中文写作方式不同.因为打空格或者tab都不能使首行缩进,一定要缩进就要用点小手段,如下:
这是首行不缩进的例子
这是首行输入4个 加上;的情况,这个 是不断行空格.
这是首行2个&ensp加上分号的显示情况,这个&ensp加分号是英文空格
这是首行1个&emsp加上分号的显示情况.这个&emsp分号是中文空格
这样虽在渲染中看得不错了,但在书写环境下看着却不舒服.所以最好还是不要这种排版, 而要尽量符合它的排版习惯.
在html中,段落并不靠首行两字符缩进来指示,而是靠增加一个空行来指示. 所以显示还是很清晰的, 当一定要符合中文出版习惯时,可以采用上述变通办法.
它认为: 首行对齐的行构成一个段落. 但段内的回车并不能在渲染环境中表现出来.
在一段文本中,你不需要输入回车, 由渲染环境根据宽度需要自动加入回车来显示,这加入的换行就是自动换行.
所以,当你需要加入回车时,多半是需要加入两个回车,以便构成段落分割.
如果我一定要在段内加入一个回车怎么办? 一般的,它是不建议你插入这种硬回车,如果一定要这么做,用2个空格+回车.
它认为: 首行由超过4个空格构成就构成了段落引用.
而缩进呢,相同的缩进构成同一个段落.而查过4个格的缩进就是代码块引用了
就像这里所示,是原样照印,回车表现为回车,空格表现为空格.
它的这种渲染环境,一定程度上破坏了我们所见即所得的直观感受,是不是一种倒退呢? 尤其是对于我们这类写代码的程序员!
原来markdown不是主要用来写代码的,而是主要用来写文章的.
它有大标题,二标题,三标题一直到六标题.标题表示了章,节,小节,小小节…,
节下面有列表, 1. 2. 3. 或a. b. c. 有序列表或无序列表或者说明性列表:
兼顾到程序员的需要,当需要保留排版格式时,可以用引用或者代码引用把它包围起来.
下面是一个无格式列表
- Markdown和扩展Markdown简洁的语法
- 代码块高亮
- 图片链接和图片上传
- LaTex数学公式
- UML序列图和流程图
- 离线写博客
- 导入导出Markdown文件
- 丰富的快捷键
hjjnote:可见csdn 支持markdown 和 markdown 扩展语法
至于图片,链接,数学公式,流程图我还不会写, 要慢慢学
hjjnote:分割线,我明白
快捷键
hjjnote:二号标题我也明白
- 加粗
Ctrl + B
- 斜体
Ctrl + I
- 引用
Ctrl + Q
- 插入链接
Ctrl + L
- 插入代码
Ctrl + K
- 插入图片
Ctrl + G
- 提升标题
Ctrl + H
- 有序列表
Ctrl + O
- 无序列表
Ctrl + U
- 横线
Ctrl + R
- 撤销
Ctrl + Z
重做
Ctrl + Y
hjjnote: 上面是在一行内就能写下的无序列表.
这些快捷键菜单栏有按钮,用多了就记住了,例如斜体用Ctrl-I ,表示斜体, 我就是这样加入标注
Markdown及扩展
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。 —— [ 维基百科 ]
使用简单的符号标识不同的标题, 将某些文字标记为粗体或者斜体,创建一个 链接等,详细语法参考帮助?。
hjjnote:粗体,斜体我知道了, 6级标题也知道, 引用用> it’s easy,
本编辑器支持 Markdown Extra , 扩展了很多好用的功能。具体请参考Github.
表格
Markdown Extra 表格语法:
项目 | 价格 |
---|---|
Computer | $1600 |
Phone | $12 |
Pipe | $1 |
hjjnote:表格已经掌握, 要想快速编辑,还是用vim 书写比较快
可以使用冒号来定义对齐方式:
项目 | 价格 | 数量 |
---|---|---|
Computer | 1600 元 | 5 |
Phone | 12 元 | 12 |
Pipe | 1 元 | 234 |
hjjnote:表格内容对齐也很简单
定义列表
-
Markdown Extra 定义列表语法:
项目1
项目2
- 定义 A
- 定义 B 项目3
- 定义 C
-
定义 D hjjnote:定义部分前面是有个冒号的:
定义D内容
hjjnote: 引用内回车即为硬回车.而且左端自动对齐.
说明式列表,内容前面加个> 表示是引用.
代码块
代码块语法遵循标准markdown代码,例如:
@requires_authorization
def somefunc(param1='', param2=0):
'''A docstring'''
if param1 > param2: # interesting
print 'Greater'
return (param2 - param1 + 1) or None
class SomeClass:
pass
>>> message = '''interpreter
... prompt'''
hjjnote:代码块的引用我记得是很简单的, 对于不同的代码类型还是需要详细了解一下
脚注
生成一个脚注1.
目录
用 [TOC]
来生成目录:
数学公式
使用MathJax渲染LaTex 数学公式,详见math.stackexchange.com.
- 行内公式,数学公式为: Γ(n)=(n−1)!∀n∈N 。
- 块级公式:
更多LaTex语法请参考 这儿.
hjjnote:数学公式以后再学, 今天先学习到这!!!
UML 图:
可以渲染序列图:
或者流程图:
离线写博客
即使用户在没有网络的情况下,也可以通过本编辑器离线写博客(直接在曾经使用过的浏览器中输入write.blog.csdn.net/mdeditor即可。Markdown编辑器使用浏览器离线存储将内容保存在本地。
用户写博客的过程中,内容实时保存在浏览器缓存中,在用户关闭浏览器或者其它异常情况下,内容不会丢失。用户再次打开浏览器时,会显示上次用户正在编辑的没有发表的内容。
博客发表后,本地缓存将被删除。
用户可以选择 把正在写的博客保存到服务器草稿箱,即使换浏览器或者清除缓存,内容也不会丢失。
注意:虽然浏览器存储大部分时候都比较可靠,但为了您的数据安全,在联网后,请务必及时发表或者保存到服务器草稿箱。
浏览器兼容
- 目前,本编辑器对Chrome浏览器支持最为完整。建议大家使用较新版本的Chrome。
- IE9以下不支持
- IE9,10,11存在以下问题
- 不支持离线功能
- IE9不支持文件导入导出
- IE10不支持拖拽文件导入
- 这里是 脚注 的 内容.
hjjnote:脚注还不太明白 ↩