markdown的基本使用

markdown的使用

关于markdown的简介博主在这里不再赘述啦,如果想了解更多,可以看看下列的链接。

创始人 John Gruber 的 Markdown 语法说明

Markdown 中文版语法说明

下面举一些简单的例子

标题

标题是每篇文章必备而且最常用的格式。
在Markdown中,如果想将一段文字定义为标题,只需要在这段文字前面加上#,再在 # 后加一个空格即可。还可增加二、三、四、五、六级标题,总共六级,只需要增加 # ,增加一个 # ,标题字号相应降低一级。如图:

image

列表

列表格式也很常用,它可以让你的文稿变得井井有条。在Markdown中,你只需要在文字前面加上 - 就可以了;如果你希望是有序列表,在文字前面加上 1. 2. 3. 即可。

注:-、1.和文字之间要保留一个字符的空格。
image

引用

如果你需要在文稿中引用一段别处的句子,那么就要用到「引用」格式。
在引用文字前加上 > 并与文字保留一个字符的空格,即可。

1
2
引用:
>Across the Great Wall we can reach every corner in the world.

Across the Great Wall we can reach every corner in the world.

粗体和斜体

Markdown 的粗体和斜体也非常简单:
两个 * 包含一段文本就是粗体的语法;
一个 * 包含一段文本就是斜体的语法。
image

链接与图片

链接:在 Markdown 中,插入链接

1
[显示文本] (链接地址)

图片:在 Markdown 中,插入图片只需要使用

1
! [显示文本] (图片链接地址)即可。

注:插入图片的语法和链接的语法很像,只是前面多了一个 !

分割线

分割线的语法只需要另起一行,连续输入三个星号 * 即可分割两段文字内容。
如图:
image

表格

当你需要在Markdown文稿中键入表格

1
2
3
4
5
   | Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is | right-aligned | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |

效果

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

待办和清单

待办事项和清单在日常工作、生活中经常被使用。
在Markdown中,你只需要在待办的事项文本或者清单文本前加上- [ ]、- [x]即可。

  • 表示未完成,- [x] 表示已完成。
    注:键入字符与字符之间都要保留一个字符的空格。
    具体呈现如下:
    image

流程图

在Markdown中,一段流程图语法以 “开头,以 “ 结尾。
在 “` 后另起一行,书写graph XX,用以确定将要绘制的流程图及其类型(XX表示流程图类型)。
流程图分为竖向和横向两大类,竖向包括自上而下和自下而上两种顺序,横向包括从右到左和从左到右两种顺序。
其对应语法分别为:graph TB/graph BT/graph RL/graph LR。
TB - top bottom(自上而下)
BT - bottom top(自下而上)
RL - right left(从右到左)
LR - left right(从左到右)
简单示例如图:
image
image
image
image
来学习一个具体案例:
image
仔细研究上述案例,会发现,++我们可以通过调整语法来调整流程图的框线、连接线,不同条件能导向不同结果++。
①对框线形状的调整,如:
image

②对箭头的调整,如:
image

只要充分掌握该语法,再复杂的流程图也完全能用Markdown书写!
更详细的流程图语法,可参见:http://knsv.github.io/mermaid/#flowcharts-basic-syntax

甘特图

我们在工作中用甘特图作计划进度表、项目进度表再合适不过了。
以如下甘特图为例说明:
image
与流程图一样,Markdown中,甘特图的语法也是以 “开头,以 “ 结尾。
在 “` 后另起一行,书写 gantt ,用以确定将要绘制的是甘特图。
标题的书写语法如下:
image
dateFormat YYYY-MM-DD规定了时间轴,title (标题文本)表示甘特图标题。
如需按项目进行划分,需键入section,空一个字符,再输入项目名称的文本(一个section和另一个section之间要空行)。
每个大项目将拆解为若干个小任务,只需在section之后另起一行,直接输入小项目名称即可。
更详细的甘特图语法,参见:http://knsv.github.io/mermaid/#styling39

代码折叠


1
2
3
4
5
6
7
8
9
<style>
.testButton { color:black;font-size:12px;padding-top:10px;padding-bottom:10px;padding-left:25px;padding-right:25px;border-width:;border-color:white;border-style:;border-radius:10px;background-color:#f3f3f3;}.testButton:hover{color:white;background-color:#0684bd;border-color:#87daff;}
</style>
<button class="testButton" onclick="document.all.child1.style.display=(document.all.child1.style.display =='none')?'':'none'">点击显\隐代码</button>
<div id="child1" style="display:none">

此处放代码

</div>


参考文献

http://note.youdao.com/iyoudao/?p=2411&vendor=unsilent14

请我喝杯咖啡~
------ 本文结束------
0%