杂谈之一 如何在csdn里使用markdown编辑器

正文

先说正事,如何将csdn默认的html编辑器改为markdown编辑器。
按照如下教程配置即可,首先找到个人中心
杂谈之一 如何在csdn里使用markdown编辑器_第1张图片
杂谈之一 如何在csdn里使用markdown编辑器_第2张图片
杂谈之一 如何在csdn里使用markdown编辑器_第3张图片
此处还能更换博客皮肤,配置完成后保存即可。然后新建博客就可以看到效果如下。
杂谈之一 如何在csdn里使用markdown编辑器_第4张图片


闲聊部分

笔者是第一次使用csdn,越深入的学习计算机方面的有关知识,就越发感受到写博客的重要性:
1. 能够将脑中的知识进行一个整理再书面表达出来,对知识的巩固和深入理解有很大好处
2. 知识如果长时间不用就会遗忘,再碰到类似的问题也会造成重复踩坑的后果,使用博客记录能够供后来查阅
3. 如果能够帮助到碰到相同问题的人也是极好

但是博客的同类产品也有很多如:csdn、博客园、github page、简书以及博客专栏等,但笔者选择了csdn是喜欢它的几个特性1:
- 兼容markdown
- seo做得很好
- 积分机制

其他产品做得也不错,有兴趣的可以自行了解各取所需。
但是笔者刚开始使用csdn时并不是很顺利,因为开始默认的编辑器是HTML,而且在百度上搜了半天都是关于markdown语法的说明,并未找到如何改为markdown编辑器的相关文档,故有了此篇。
本博客原创内容到此结束,难免疏漏还请指教。


补充:Markdown语法小结

本Markdown编辑器使用StackEdit修改而来,用它写博客,将会带来全新的体验哦:

  • Markdown和扩展Markdown简洁的语法
  • 代码块高亮
  • 图片链接和图片上传
  • LaTex数学公式
  • UML序列图和流程图
  • 离线写博客
  • 导入导出Markdown文件
  • 丰富的快捷键

图片

  • 插入图片基本语法
    ![图片Alt标签(seo关键字)](图片链接 "图片标题(悬浮显示)")
  • 插入方式
    • 上传到csdn(菜单栏)
    • 自建github图片仓库
    • 把图片存入md文件(待补充)

补充:自建github图片仓库并在md文档中引用

首先,如果你是git小白,请看入门教程2:
在掌握一定git基础后,操作具体流程为:

1 创建远程仓库(github为例)与对应本地仓库(windows为例)
登录自己的github网页端,点击add repo创建仓库如下图1:
杂谈之一 如何在csdn里使用markdown编辑器_第5张图片
新建远程仓库后按图2命令提示操作后,创建本地仓库:
杂谈之一 如何在csdn里使用markdown编辑器_第6张图片

注:若操作失误需要再次添加远程仓库会与第一次添加的冲突,需要先删除然后再次添加即可3,即:

git remote rm origin
git remote add origin git@...

2 将需要上传的图片复制到本地仓库,按如下代码添加、提交、推送后即可在远程仓库访问
杂谈之一 如何在csdn里使用markdown编辑器_第7张图片

3 访问远程仓库并右键所需图片即可复制图片地址,再按照基本格式即可引用图片
大功告成!

所参考教程4.


msdn-markdown快捷键

  • 加粗 Ctrl + B
  • 斜体 Ctrl + I
  • 引用 Ctrl + Q
  • 插入链接 Ctrl + L
  • 插入代码 Ctrl + K
  • 插入图片 Ctrl + G
  • 提升标题 Ctrl + H
  • 有序列表 Ctrl + O
  • 无序列表 Ctrl + U
  • 横线 Ctrl + R
  • 撤销 Ctrl + Z
  • 重做 Ctrl + Y

Markdown及扩展

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。 —— [ 维基百科 ]

使用简单的符号标识不同的标题,将某些文字标记为粗体或者斜体,创建一个链接等,详细语法参考帮助。

本编辑器支持 Markdown Extra ,  扩展了很多好用的功能。具体请参考Github.

表格

Markdown Extra 表格语法:

项目     | 价格
-------- | ---
Computer | $1600
Phone    | $12
Pipe     | $1

可以使用冒号来定义对齐方式:

| 项目      |    价格 | 数量  |
| :-------- | --------:| :--: |
| Computer  | 1600 元 |  5   |
| Phone     |   12 元 |  12  |
| Pipe      |    1 元 | 234  |

效果

项目 价格
Computer $1600
Phone $12
Pipe $1

可以使用冒号来定义对齐方式:

项目 价格 数量
Computer 1600 元 5
Phone 12 元 12
Pipe 1 元 234

定义列表

Markdown Extra 定义列表语法:

项目1
项目2
:   定义 A
:   定义 B

项目3
:   定义 C

:   定义 D

    > 定义D内容
效果
项目1
项目2
定义 A
定义 B
项目3
定义 C

定义 D

代码块

代码块语法遵循标准markdown代码,例如:

``` python
@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'''

效果

@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'''

脚注

生成一个脚注[^脚注名].
  [^脚注名]: 这里是 **脚注***内容*.
  ps:但是对于非本地md文档(即网页端)来说脚注没有发挥其特性,因为浏览器会将脚注视作链接在新窗口中打开

效果
生成一个脚注5.

目录

用 `[TOC]`来生成目录:

[TOC]

效果

      • 正文
      • 闲聊部分
  • 补充:Markdown语法小结
    • 图片
      • 补充:自建github图片仓库并在md文档中引用
    • msdn-markdown快捷键
    • Markdown及扩展
      • 表格
      • 定义列表
      • 代码块
      • 脚注
      • 目录
      • 数学公式
      • 跳转链接
      • UML 图:
    • 离线写博客
    • 浏览器兼容
      • 参考

数学公式

使用MathJax渲染LaTex 数学公式,详见math.stackexchange.com.

 - 行内公式,数学公式为:$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$。
 - 块级公式:

$$	x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

更多LaTex语法请参考 [这儿][3].
  • 行内公式,数学公式为:Γ(n)=(n1)!nN
  • 块级公式:

x=b±b24ac2a

更多LaTex语法请参考 这儿.

跳转链接

**方式一**
[百度](http:www.baidu.com)
**方式二**
[搜狐][8]
[8]:http:sohu.com

方式一
百度
方式二
搜狐
ps:为了方便编辑,链接应统一放在末尾,此处仅为了说明其用法, 此外再结合角注语法可以完成参考文献的格式

UML 图:

可以渲染序列图:

```sequence
张三->李四: 嘿,小四儿, 写博客了没?
Note right of 李四: 李四愣了一下,说:
李四-->张三: 忙得吐血,哪有时间写。
Created with Raphaël 2.1.2 张三 张三 李四 李四 嘿,小四儿, 写博客了没? 李四愣了一下,说: 忙得吐血,哪有时间写。

或者流程图:

```flow
st=>start: 开始
e=>end: 结束
op=>operation: 我的操作
cond=>condition: 确认?

st->op->cond
cond(yes)->e
cond(no)->op
Created with Raphaël 2.1.2 开始 我的操作 确认? 结束 yes no
  • 关于 序列图 语法,参考 这儿,
  • 关于 流程图 语法,参考 这儿.

离线写博客

即使用户在没有网络的情况下,也可以通过本编辑器离线写博客(直接在曾经使用过的浏览器中输入write.blog.csdn.net/mdeditor即可。Markdown编辑器使用浏览器离线存储将内容保存在本地。

用户写博客的过程中,内容实时保存在浏览器缓存中,在用户关闭浏览器或者其它异常情况下,内容不会丢失。用户再次打开浏览器时,会显示上次用户正在编辑的没有发表的内容。

博客发表后,本地缓存将被删除。 

用户可以选择 把正在写的博客保存到服务器草稿箱,即使换浏览器或者清除缓存,内容也不会丢失。

注意:虽然浏览器存储大部分时候都比较可靠,但为了您的数据安全,在联网后,请务必及时发表或者保存到服务器草稿箱

浏览器兼容

  1. 目前,本编辑器对Chrome浏览器支持最为完整。建议大家使用较新版本的Chrome。
  2. IE9以下不支持
  3. IE9,10,11存在以下问题
    1. 不支持离线功能
    2. IE9不支持文件导入导出
    3. IE10不支持拖拽文件导入

参考


  1. 个人技术博客的选择:CSDN、博客园、简书、知乎专栏还是Github Page?, 牧码人小鹏 ↩
  2. 廖雪峰的git教程 ↩
  3. github常见操作和常见错误!错误提示:fatal: remote origin already exists. ↩
  4. no_surprise, 利用github存储图片供博客引用 ↩
  5. 这里是角注示例内容. ↩

你可能感兴趣的:(其它)