Markdown 指南

前几天学习了markdown,然后一直在用,很喜欢这种格式即内容的写作形式。在简书写了几篇,对固定链接的格式很不满意,于是寻找能够支持markdown、固定链接显格式、支持自定义域名的博客平台。Github是个很好的选择,在折腾完Jekyll和Octopress几近筋疲力尽的时候,一束光芒照过来,我看到了hexo

说远了…这篇文章是想介绍一下markdown这种写作形式。

本质上,类似于html,markdown也是一种标记型语言,ie,用某些字符(不像html用字符串)标示某种格式,只是标记格式不同罢了。

比如:###Hello Word,标示出helloword是三级标题,markdown进行渲染后就成了对应大小、加粗的格式。

介绍markdown的教程太多了,我不打算做无用的重复,给出我认为必读的几个供大家参考。

  1. 鲁塔弗:markdown 简明语法
  2. 图灵社区:怎样使用Markdown
  3. 简书:献给写作者的 Markdown 新手指南
  4. 官方文档(中文版):Markdown 语法说明
  5. 用Markdown来书写你的博客

说明一下,上述1-3是并列关系,不同人总结的教程,建议都看。4比较繁琐,可以暂时不看,以后需要时再查询即可。

还有,markdown就这么点东西,学会了就一劳永逸了,性价比很高!

下面给出几个编辑器,大家边学边练。

好了,开始你的markdown之旅吧!

markdown 番外篇

开博后写过一篇Introduction to markdown,给出了几个介绍markdown的教程。这几个教程或是简明易懂,或是全面规范,可以作为很好的入门教材或查阅手册。

在实际的使用当中,我发现有些用法不是这些教程里能够找到的,或者教程里没有进行应有的强调导致使用时容易出错。本文就对这样的问题进行汇总,并会不定期更新。

  1. 删除线。

    方法:在要划删除线的文本前后添加~~

    示例:~~看《冰与火之歌》~~

    解析为: 看冰与火之歌

  2. 代码块中html代码显示不正常,<、>被解析为&gt;
    &lt;

    原因:markdown是一个语法规范,具体的解析可以使用不同的程序,而不同程序对规范的完成度也未必相同。hexo 所用的 marked 解析程序,无法对代码块中<、>做正确解析,需要人工矫正。

    方法:标明语言类型html

    示例:

    解析为:

  3. 有序列表。

    问题:有序列表每项中包含若干段落时,这几个列表项得不到正确解析。

    方法:在每个列表项中各段落之前加一个空格。

    示例:

1
2
3
4
5
6
7
1. foo

 foo

2. bar

 bar

解析为:

  1. foo

    foo

  2. bar

    bar

轻松搞定Markdown

之前写过《Markdown指南》《markdown
番外篇》
用来介绍Markdown,前者是入门资料索引,后者是几个稍微高级的用法,都只是介绍了片面,不太好。

使用Markdown写博客已经三个月了,对这个标记语言很是喜欢。现在流行的教程,要么就是太复杂太难以理解,要么就是太简单太肤浅,稍微高级点的用法没有提及。本文的初衷就是用最容易理解的方式,把Markdown入门到高级用法一一介绍给读者。看完之后,你不仅可以开始使用Markdown写东西,在日常使用中也随时可以打开这篇博客参考各种用法。

为什么学习Markdown?别问为什么,尽管学习就好了。这么简单的东西,一会就能学会,受益可能终生,太值了。

怎么学习Markdown?我认为最好的方法是通过示例,本文正式采用这样的方法。

在哪可以使用Markdown? 你可以在简书Logdown这样的免费平台用Markdown写博客。如果你愿意折腾,也可以像我一样,使用hexo搭建自己的博客,并用Markdown书写博客,请参考拙作《hexo系列教程》。另外,现在写论文也流行使用Markdown,不学你就out了!

怎样开始?打开这个网址,把下面学到的东西在这个里面练习。左侧是Markdown,右侧是实时的显示。

还要注意什么?一个效果,有时候可以通过不同的方式生成,比如无序列表可以用-
+ *
。本文从实践出发,只列举最好用的一种。读者也只需要学习一种。

以下是Markdown代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
#这里是一级标题
###这里是三级标题
######这里是六级标题,就到这里了,木有七级! 段落前面没有缩进,看到了吧。   要想使用缩进,在中文输入法中改成「全角」输入,再按两个空格 行尾一个回车换行,显示效果依然是是一行。
我说的对吧~ 想要分成两行,需要在行尾输入两个空格。
我说的对吧~ 想要开始一个新的段落,乖乖的按两下回车吧 我说的对吧~ **两个星号包围的是粗体** *一个星号包围的是斜体* > 引用内容,多行的话,用两个空格结尾吧
是吧~ `反引号包围的是行内代码`,这个按键在「Tab」上边 ``嵌套的话,可以使用`两个双引号`嵌套在外面`` ```python
#三个反引号包围的是代码块。
#会显示行号。
#也有高亮显示
#我上面加了python,你也可以不加。如果不能高亮,那么还是加上吧。。另外,如果你的代码块包围的是html,那你应该写html而不是python
import os
print os.sep
```
嵌套的话,可以使用六个反引号嵌套在外面。 1. 有序列表1,注意点之后的空格。
2. 有序列表2.
1. 我这里写成1,在显示时还是3,厉害不。 1. 有序列表1
详细内容,注意前面有一个空格
2. 有序列表2
详细内容 - 无序列表1
- 无序列表2
- 无序列表3
- 小1,注意前面有一个空格
- 小2 超级链接:[我的博客](http://zipperary.com) 插入图片:![好看不](http://ww2.sinaimg.cn/large/5e8cb366jw1e62o63tkv3j20dh078q5a.jpg) 另外,markdown完全兼容html,你可以用html插入这些东西,例如: <iframe height=498 width=510 src="http://player.youku.com/embed/XMjI2MjU3MDMy" frameborder=0 allowfullscreen></iframe> ~~删除线~~ 分割线用`---`,注意单独一样,上面必须是一个空行 --- 更多高级的格式,请果断插入html标签

以下到结尾处是效果:

这里是一级标题

这里是三级标题

这里是六级标题,就到这里了,木有七级!

段落前面没有缩进,看到了吧。

  要想使用缩进,在中文输入法中改成「全角」输入,再按两个空格

行尾一个回车换行,显示效果依然是是一行。

我说的对吧~

想要分成两行,需要在行尾输入两个空格。

我说的对吧~

想要开始一个新的段落,乖乖的按两下回车吧

我说的对吧~

两个星号包围的是粗体

一个星号包围的是斜体

引用内容,多行的话,用两个空格结尾吧

是吧~

反引号包围的是行内代码,这个按键在「Tab」上边

嵌套的话,可以使用`两个双引号`嵌套在外面

1
2
3
4
5
6
#三个反引号包围的是代码块。
#会显示行号。
#也有高亮显示
#我上面加了python,你也可以不加。如果不能高亮,那么还是加上吧。。另外,如果你的代码块包围的是html,那你应该写html而不是python
import os
print os.sep

嵌套的话,可以使用六个反引号嵌套在外面。

  1. 有序列表1,注意点之后的空格。
  2. 有序列表2。
  3. 我这里写成1,在显示时还是3,厉害不。
  1. 有序列表1

    详细内容,注意该行和上面一行,前面有一个空格

  2. 有序列表2

    详细内容

  • 无序列表1
  • 无序列表2
  • 无序列表3
    • 小1,注意前面有一个空格
    • 小2

超级链接:我的博客

插入图片:

好看不

另外,markdown完全兼容html,你可以用html插入这些东西,例如:

删除线

分割线用---,注意单独一行,上面必须是一个空行


更多高级的格式,请果断插入html标签


Markdown指南的更多相关文章

  1. <简明>Markdown指南

    什么是Markdown?Markdown是一种轻量级的「标记语言」,通常为程序员群体所用,目前它已是全球最大的技术分享网站 GitHub 和技术问答网站 StackOverFlow 的御用书写格式. ...

  2. cmake简明使用指南

    cmake简明使用指南 Last update 2018/8/8 先执行cmake生成makefile,然后看看里面的内容,(至少在ubuntu16.04上的cmake3.5.1上),有如下内容提供: ...

  3. Markdown 指南

    Markdown 是一种轻量级的「标记语言」,使用用特殊的 Markdown 文档处理器将 Markdown 语法翻译成预设的文档格式.标题大小等,一般用于展示时输出的是 HTML.这个教程可以让使用 ...

  4. <进阶版>Markdown指南

    有道云笔记内置Markdown编辑器和使用指南. “进阶版”有道云笔记Markdown指南,教你如何进一步掌握待办.清单.流程图和甘特图. 0 待办和清单 待办事项和清单在日常工作.生活中经常被使用. ...

  5. [简明版] 有道云笔记Markdown指南

    使用有道词典配合Markdown,可以快速准确做出美观精致的笔记,下面我们来看一下如何使用有道词典的MarkDown功能. 什么是Markdown?Markdown是一种轻量级的「标记语言」,通常为程 ...

  6. Ubuntu16.04+Tensorflow+CUDA9.0+cuDNN7.0 环境简明搭建指南

    最近在研究风格化得内容,发现搭建环境实在是很头疼的事情,虽然网上已经有各路大神总结整理好了很多搭建指南,各种问题的解决方案都已经罗列出来供大家参考.然后参考终究是参考,真正自己上手,发现仍旧是各种坑, ...

  7. 初创互联网公司简明创业指南 - YC新掌门Sam Altman

    本文只是一个创业指南的简明版 - 更详细的版本请查看:http://startupclass.samaltman.com 创业之前,你更应该去拥有一个好的创意,而不是一个公司.如果开始前你拥有一个好的 ...

  8. Git简明使用指南[转]

    git - 简易指南 助你开始使用 git 的简易指南,木有高深内容,;). Tweet 作者:罗杰·杜德勒 感谢:@tfnico, @fhd and Namics 其他语言 english, deu ...

  9. 【软件工具】easyExcel简明使用指南

    easyExcel简介 Java领域解析.生成Excel比较有名的框架有Apache poi.jxl等.但他们都存在一个严重的问题就是非常的耗内存.如果你的系统并发量不发的话可能还行,但是一旦并发上来 ...

随机推荐

  1. linux:安装并使用activeMQ

    1.下载安装包:curl -O https://archive.apache.org/dist/activemq/5.14.0/apache-activemq-5.14.0-bin.tar.gz 2. ...

  2. 处理Task引发的异常

    处理方法:线程启动后,使用try-catch,通过wait或者waitall来捕获异常. 单个Task的情况: System.Threading.Tasks.Task task1 = new Syst ...

  3. PyCharm之python书写规范--消去提示波浪线

    强迫症患者面对PyCharm的波浪线是很难受的,针对如下代码去除PyCharm中的波浪线: # _*_coding:utf-8_*_ # /usr/bin/env python3 A_user = & ...

  4. Caffe和py-faster-rcnn日常使用备忘录

    罗列日常使用中遇到的问题和解决办法.包括: { caffe使用中的疑惑和解释: 无法正常执行 train/inference 的情况: Caffe基础工具的微小调整,比如绘loss曲线图: 调试pyt ...

  5. JQuery 标签之间组合取值

    <body> <div></div> <input type="text" value="first-1" /> ...

  6. Give root password for maintenance(or type control -D to continue)

    2017-09-30 18:12:08 1:错误如图,本来开机准备用一下虚拟机,就出现一个这,为啥记录一下呢,因为网上好多不是很靠谱. 原因可能是之前关闭虚拟机的时候不小心出现异常了: 2:解决办法: ...

  7. CentOS6 安装gnutls

    所有用的的包:https://pan.baidu.com/s/1EQYf3gsK_xT6kCAjrVs2aQ wget http://download.savannah.gnu.org/release ...

  8. [转]Centos 查看端口占用情况和开启端口命令

    http://www.cnblogs.com/xqzt/p/4919191.html 1.Centos 查看端口占用 比如查看 80 端口占用情况使用如下命令: lsof -i tcp:80 2.列出 ...

  9. 一起学Hive——详解四种导入数据的方式

    在使用Hive的过程中,导入数据是必不可少的步骤,不同的数据导入方式效率也不一样,本文总结Hive四种不同的数据导入方式: 从本地文件系统导入数据 从HDFS中导入数据 从其他的Hive表中导入数据 ...

  10. 一起学Hadoop——TotalOrderPartitioner类实现全局排序

    Hadoop排序,从大的范围来说有两种排序,一种是按照key排序,一种是按照value排序.如果按照value排序,只需在map函数中将key和value对调,然后在reduce函数中在对调回去.从小 ...