[刊首语]Markdown -- 入门基础

Markdown是一种轻量级的“标记语言”,它的优点很多,目前也越来越多的写作爱好者、撰稿者广泛使用。看到这里请不要被“标记”、“语言”所迷惑,Markdown的语法十分简单。常用的标记符号也不超过十个,这种相对于更复杂的HTML标记语言来说,Markdown可谓是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。

一. 认识Markdown

在刚才的导言里提到,Markdown是一种用来写作的轻量级“标记语言”,它用简洁的语法代替排版,而不像一般我们用的字处理软件WordPages有大量的排版、字体设置。它使我们专心于码字,用“标记”语法来代替常见的排版格式。例如,此文从内容到格式,甚至插图,键盘就可以通通搞定了。目前来看,支持Markdown语法的编辑器有很多,包括很多网站(例如,简书也支持了Markdown的文字录入。Markdown从写作到完成,导出格式随心所欲,你可以导出HTML格式的文件用来网站发布,用Markdown写出的简历也可以十分方便的导出PDF格式,更能得到HR的好感。本文的所有格式、内容都是用Markdown写成。

Markdown语法说明文档

这里可以看到官方的Markdown语法规则文档,当然,后文我也会用自己的方式阐述这些语法的具体用法。

使用Markdown的优点

  • 专注你的文字内容而不是排版样式
  • 轻松导出HTML、PDF和本身的.md文件
  • 纯文本内容,兼容所有的文本编辑器与字处理软件
  • 可读、直观,适合所有人的写作语言

Markdown编辑器推荐

Atom
Atom

Atom -- 见仁见智

Atom -- 来自Github的Markdown编辑器。是的,这里没有之一,只有一款推荐。原因很无厘头,笔者只使用过Atom这一款Markdown编辑器,并且很顺手。Atom包含了主流的Markdown功能,如下:

  • 语法高亮,并且视觉效果很好;
  • Markdown格式预览,左右分屏直观有效;
  • 来自GitHub的品牌效应,值得信赖。

关于Atom的一些讨论请参见知乎,见仁见智吧。

Atom的用户手册:

二. Markdown常用语法

Markdown的语法简洁将会让你觉得,一旦熟悉就一劳永逸!

标题与字体

  • 标题采用符号“#”表示,对应几级标题就是几个“#”符号;
  • 常规字体直接输入;
  • 斜体采用星号“*”环绕,例如输入*斜体*将得到 斜体
  • 粗体采用双星号“**”环绕,例如输入**粗体**将得到 粗体
  • 删除线采用波浪线双“~~”环绕,例如输入~~删除~~将得到 删除

引用与超链接

至此本文已经多次用到超链接,这里将超链接的使用方法详细叙述如下:

  • 一个方括号,里面放上图片的替代文字
  • 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。

超链接语法格式如下:

[link_label](https://github.com/atom/atom)

其中,「link_label」是链接的替代文字,( )内是网络url或者本地路径。

区块引用与分割线

区块引用主要应用于代码等其他格式文件的引用,采用代码块标记符号表示,或者更简单的通过在行开始添加Tab制表符或者4个空格的缩进即可(能够实现代码高亮)。

输入以下例子代码:

<pre><code>
return shell_exec("echo $input | $markdown_script");
<\code><\pre>

或者:

\t return shell_exec("echo $input | $markdown_script");

得到的输出如下:
<pre><code>
return shell_exec("echo $input | $markdown_script");
</code></pre>

可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面几种输入方式都能够得到分割线:

---

***


列表与选项

无序列标采用星号“*”或者横线“-”表示:

输入:

* 无序列表项目

- 无序列表项目

输出:

  • 无序列表项目
  • 无序列表项目

有序列标采用数字“1. ”表示:

输入:

  1. 有序列表项目
  2. 有序列表项目

输出:

  1. 有序列表项目
  2. 有序列表项目

层次列标采用符号“-+”表示:

输入:

- 外层列表项目

+ 内层列表项目

+ 内层列表

+ 内层列表

+ 内层列表项目

+ 内层列表

+ 内层列表

- 外层列表项目

输出:

  • 外层列表项目
  • 内层列表项目
    • 内层列表
    • 内层列表
  • 内层列表项目
    • 内层列表
    • 内层列表
  • 外层列表项目

图表与公式

图片

图片使用一种和链接很相似的语法来标记,详细叙述如下:

  • 一个感叹号 !
  • 接着一个方括号,里面放上图片的替代文字
  • 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。

插入图片的语法如下(仅在超链接语法前添加了感叹号“!”):

![img_label](/path/to/img.jpg "Optional title")

其中,「img_label」是图片的替代文字,( )内是图片的地址(网络url或者本地路径),“ ”内是图片题注。

Tips: 在Atom编辑器内,可以通过输入 img 然后使用 Tab 键直接调出上述图片插入模版。

表格

新版本的Markdown已经能够支持表格了(老版本还得通过ccs曲线救国),直接采用“|”进行列的分割,采用“:----”将标题栏与正文分给,这种所见即所得的方式非常方便。

name-1 name-2 address zone
John Smith 123 Main St. Springfield
Mary Jones 456 Pine St. Dover
Jim Baker 789 Park Ave. Lincoln

Tips: 在Atom编辑器内,可以通过输入 table 然后使用 Tab 键直接调出上述表格插入模版。

公式

公式的输入有三种方式:

  • 插入公式图片:显然这么不儒雅的行为不太适合部分文化人;
  • LaTeX公式+网站解析:将LaTeX的公式放在codecogs上进行解析,即将网址末尾的“LaTeX”字样替换为公式代码,最后将返回正确的公式以图片形式引入Markdown文件;
  • MathJax引擎:儒雅漂亮高效,但是需要配置引擎,附上CSDN参考文档,据说stackoverflow上的公式就是这么处理的,但笔者尚未尝试。

这里,附上“LaTeX公式+网站解析”方式的示例,输入以下代码(点击网址即可看到解析结果):

![eqn:solution](http://latex.codecogs.com/svg.latex?\Large%20x=\frac{-b\pm\sqrt{b^2-4ac}}{2a})

将得到公式如下:

eqn:solution
eqn:solution

三. Markdown应用举例

网络交流平台

支持Markdown的网络交流平台推荐:

  • 简书:交流故事,沟通想法,一个基于内容分享的社区,Markdown的简洁美观尽收眼底;
  • GitHub:一个码农界鼎鼎大名的代码托管网站,其说明文档和Pages功能均采用Markdown格式;
  • CSDN:最大的中文IT社区,其博客支持Markdown格式。

微信公众平台

作为当下火热的移动互联网渠道,微信公众平台还不支持Markdown格式,很遗憾。对此,知乎上已经发起了讨论。不过好消息是,浏览器插件markdown-here提供了很好的解决方案,操作方法见百度经验

Markdown转换为PDF

推荐一个格式转换工具markdown-pdf

个人网站/私人札记

基于上述推荐的神奇网站,构建个人网站和私人札记已经变得简易化了。历史在发展,时代在进步,当前的个人营销或者是学习笔记的形式也在革新……

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 195,719评论 5 462
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 82,337评论 2 373
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 142,887评论 0 324
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,488评论 1 266
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,313评论 4 357
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,284评论 1 273
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,672评论 3 386
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,346评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,644评论 1 293
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,700评论 2 312
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,457评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,316评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,706评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,990评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,261评论 1 251
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,648评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,859评论 2 335

推荐阅读更多精彩内容

  • 为什么学习Markdown 自从搭建了 Hexo 博客之后,发现还有 Markdown 这种写文章的方法,想到以后...
    lifeColder阅读 20,094评论 10 216
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 11,952评论 4 60
  • 【今日话题】: 你报过多少种网络课程?学习情况如何? 1.阿何《时间管理》 2.阿何《60天引爆你的学习力》 3....
    云昊YH阅读 247评论 0 1
  • 今天是端午,在朋友圈看到了浓浓的相聚之情,而我一个人,在学校的宿舍。 作为应届毕业生,在学校却害怕撞见师弟师妹们,...
    小哈喽阅读 313评论 2 1