Markdown语法样例

  MarkDown是轻量级的标记语言,它的语法类似Html的简化版,比Html更方便记忆。自从年初用markdown搭建了小组内部文档系统网站后,就迷上了它。

  一个文档的元素无非是标题、段落、链接、样式等,在office word里这些是通过一些操作来标记的,标记完后word会直接显示,但只有装了相关软件才能查看和编辑word,想象下office的笨重还有linux、windows、mac系统跨平台编辑、word与其他格式文件转换的问题,总让人痛苦不堪。此外,word各种样式繁琐,编辑不当容易丢失、存储还有文档格式损坏问题,因此,Markdown无疑是来拯救我们的。

  Markdown相比Html学习成本低,且排版格式好、可读性强。它是纯文本格式,可跨操作系统跨软件平台共享。通过一些标记来定义段落、表格、图片、链接、样式等,文档保存后缀为md,文档可转换为pdf、html等多种格式,码字的人类因此可专注写作。

  夙夜札记所用的Hexo文档就是Markdown,那么开篇总结下Markdown的通常用法。

1. Markdown语法导图

Markdown语法图

2. Markdown样例对照效果

2.1 标题

# 这是一级标题的效果

这是一级标题的效果

## 这是二级标题的效果

这是二级标题的效果

### 这是三级标题的效果

这是三级标题的效果

#### 这是四级标题的效果

这是四级标题的效果

##### 这是五级标题的效果
这是五级标题的效果
###### 这是六级标题的效果
这是六级标题的效果

2.2 分割线

***

2.3 段落

段落:段落间空行或者两个空格回车强制换行

2.4 区块

>区块测试:在段落前加\>符号 

区块测试:在段落前加>符号

2.5 列表

+ 无序列表符号加号  
- 无序列表符号减号
* 无序列表符号星号    
1.  有序列表符号,数字加英文句号
2.  序号与文字间有至少一个空格
4.  即使这行标号错误,最终显示会是正确的 
  • 无序列表符号加号
  • 无序列表符号减号
  • 无序列表符号星号
  1. 有序列表符号,数字加英文句号
  2. 序号与文字间有至少一个空格
  3. 即使这行标号错误,最终显示会是正确的

2.6 文字样式

*斜体是一个成对星号*

斜体是一个成对星号

**粗体是两个成对星号**

粗体是两个成对星号

2.7 表格

| 默认文字居左  |*文字居中*     | **文字居右** |
| ------------- |:-------------:| ------------:|
| 无冒号        | 一对冒号      | 冒号居右     |
默认文字居左 文字居中 文字居右
无冒号 一对冒号 冒号居右

2.8 链接

[行内链接样例:夙夜札记链接](xinduihong.cn)  

行内链接样例:夙夜札记链接

[本文学习参考链接][1]

本文学习参考链接

[1]:  http://wowubuntu.com/markdown/#philosophy   "Markdown 语法说明 (简体中文版)"

3. 结束语

  对比原文和效果,可以看出Markdown不同标记在网页的展示。使用Markdown要注意符号之后的空格,缺少空格时语法会失效。

  本文样例中缺少自动链接、隐式链接,再补充说明下:

  隐式链接可以省略链接地址,在其他地方对链接内容进行补充。当文档涉及链接太多时,使用隐式链接,在段末时对缺省的各链接地址进行统一定义,修改时比较方便。

  自动链接用于不需要额外名称的链接,支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用尖括号包起来,Markdown就会自动把它转成链接。

  Markdown编辑时需要看实时显示效果的话需要使用编辑工具预览,现在印象笔记、有道云笔记、Tower也开始支持Markdown,而其他好用的markdownd编辑器也很多,降低了编辑和阅读共享的门槛。
  
声明:原创文章在公众号“夙夜札记”同步,微信ID为RheaTime,如需转载请联系本人!

评论

Hello world

  这里是夙夜札记,你一定是上辈子拯救了银河系才被传送至此!

  这是一篇义正言辞的序。

  夙夜,意寓勤勉,旨在激励自己勤勤恳恳、坚持不懈;札记,即后期发布的内容将为小女子的读书笔记、学习心得、填坑记录。

  夙夜札记的Logo是由三个图层叠加成的:第一层是一个手持镂空树叶研究的小女孩,树叶掩面;第二个图层是树叶放大的叶脉轮廓;第三层是浩瀚渺茫、难以分辨的星轨图。镂空树叶在不同的背景显示不同的颜色,随着环境的变化而变换。

  正如Logo中的意像,个人的认识是有限的、片面的,一叶障目、一叶知秋、一花一世界,作为人类的一员,难以摆脱自然属性的局限,There is somthing greater than us.You will nerver know what’s out there or where the limit is.研究对象从来不是当前看到的那样,它不会一成不变,人类从世界获得的不过是身体驱壳上自带的传感器能输入的信息,诸如形、声、闻、味、触,能做的事情也是有限,保持一颗好奇的童心,努力放大一些细微的事物去寻求它的本真,追逐星辰大海,去探寻这个世界变幻无穷的道,这是我的信仰,朝闻道,夕死可矣。

  如果你是IT圈内人士,欢迎交流互粉;如果你脑洞无边无际,请献计献策;如果你是黑客or极客,咱们做朋友吧;如果你是火星人,请带我离开地球村!

  本站使用的是Hexo,一个基于Node的静态博客框架,它可以将Markdown文档方便的生成静态网页。本站主题是ppoffice的icarus。有建站需求的小伙伴可以留下脚印。
  
  这是第一次发布,下面是本篇Hello world通过hexo诞生的记录:

Create a new post

1
$ hexo new "My New Post Hello world"

More info: Writing

Run server

1
$ hexo server

More info: Server

Generate static files

1
$ hexo generate

More info: Generating

Deploy to remote sites

1
$ hexo deploy

More info: Deployment

声明:原创文章在公众号“夙夜札记”同步,微信ID为RheaTime,如需转载请联系本人!

夙夜札记

评论