使用MarkDown快速书写技术博客并发布在CSDN及个人博客网站上


 

使用MarkDown快速书写技术博客并发布在CSDN及个人博客网站上一、背景介绍二、常用语法1.标题2.代码区块3.流程图、时序图、甘特图4.链接及图片三、编辑器四、转化HTML发布在个人网站或博客中

一、背景介绍

Markdown 是一个 Web 上使用的文本到HTML的转换工具,可以通过简单、易读易写的文本格式生成结构化的HTML文档。目前 github、Stackoverflow 等网站均支持这种格式。这样,我可以使用MarkDown语法写完总结或者博客后,很简单的同时发布在CSDN以及个人网站上。

Markdown 语法的目标是:成为一种适用于网络的书写语言。

 

二、常用语法

 

可以在markdown中文网站进行markdown的基本语法学习:http://www.markdown.cn,一般我常用标题及段落、代码区块、流程图、链接及图片,完全可以满足你基本的写博客的需求。

 

1.标题

Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。

类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),例如:

 

任何数量的 = 和 - 都可以有效果。

类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如:

 

你可以选择性地「闭合」类 atx 样式的标题,这纯粹只是美观用的,若是觉得这样看起来比较舒适,你就可以在行尾加上 #,而行尾的 # 数量也不用和开头一样(行首的井字符数量决定标题的阶数):

 

2.代码区块

使用即代表下面的文本为代码区块,使用结束或者直接跳行结束,markdown语法可以以换行来区分该次操作的结束。

 

3.流程图、时序图、甘特图

markdown画流程图的功能也是我喜欢它的一点,利用强大的markdown编辑器,这种画流程图的体验会让你瞬间爱上markdown,我推荐typora和这篇教程:https://jingyan.baidu.com/article/48b558e3035d9a7f38c09aeb.html

4.链接及图片

链接:方括号,在里面填写链接文字,然后是圆括号,首先必须有链接网址,然后空格后可以填写链接的title文字,title需要使用双引号括起来,当然你可以省略title。

 

图片:图片和链接类似,只是在最开始加上!即可,在方括号中是图片的替代文字,当图片找不到时会显示,普通括号中首先是图片的链接地址,然后空格后输入title文字,title同样可以省略。

 

三、编辑器

同样,在www.markdown.cn中有推荐的免费markdown编辑器,可以自行试并选择自己中意的。 我这里推荐一款收费的markdown编辑器,typora,我推荐它的理由有三点:一、支持[TOC]生成文档目录;二、支持画流程图的简明语法和标准语法两种;三:支持导出为PDF、HTML等多种格式。

四、转化HTML发布在个人网站或博客中

使用markdown编辑器自带的导出功能将markdown文本导出为HTML文本后,你可以直接发布在网站或者博客中,目前大多博客网站都支持markdown,当然你也可以基于该HTML文件进行一些渲染,使其更加漂亮美观。

我目前的大多数总结都是markdown文本编写,介于HTML和纯文本之间的一种语言,可以很方便的转换并发布。