使用markdown书写程序员博客

关于markdown

markdown是一种轻量级的标记性语言,类似于HTML,提供了一种格式规范,使用纯文本来描述带格式的文本,相对于HTML,markdown更加易于读写,并且内置脚本很方便地转换,这极大地简化了编写内容到网页渲染的工作。

程序员作为一个需要不断充电学习的职业,在工作过程中,往往积累了大量的知识,大部分人使用笔记工具、博客、手写等方式输出内容,以便归纳总结。本人之前一直使用手写笔记+印象笔记的方式来沉淀知识,好处是易于记录与查找,但没有分享交流的过程,所以准备将沉淀的知识输出到博客,以供编程爱好者批评指正,大家一起学习进步。

本文旨在介绍如何使用markdown书写自己的博客,同时介绍两款比较好的markdown编辑工具,阅读此篇内容应该能够帮助许多人开始博客之旅的第一步。

markdown编辑工具

Quiver

这是一款程序员的印象笔记,能够记录文字与代码,使用cell的概念来区分内容的排版方式,支持markdown、LaTeX、流程图等。功能上足够强大,能够精美地排版程序员所记录的大部分内容。

Quiver中的三种不同cell

使用Quiver最大的好处就是可以按照不同内容来很容易地输出精致的格式,支持云同步。值得注意的是,Quiver可以很方便地将内容转为markdown格式,这意味着你的内容如果只有文字、图片、代码的情况下,只需要在Quiver中编写内容——转为markdown——粘贴到blog,如此简单好用,甚至用不到markdown的语法!

MWeb

据说是国人制作的一款markdown编写工具,真实性无从考据。看名字就能知道,这是一款专注于用markdown来编写Web的工具,所提供的markdown编辑功能要比Quiver强大,快捷键设置的也比后者合理。

看工具栏就知道MWeb的专注与强大

MWeb的实际体验非常流畅,从编写到发布是无缝的,更能专注于内容的创作,对表格、图片、文件的支持较好,可惜的是不支持云同步,不过可以使用备份功能间接解决。发布功能很强大,支持多个发布服务。

一键发布到博客的功能很实用,但对国内博客服务的支持较弱

markdown语法

即使是使用最简单的博客发布方案(Quiver导出markdown),其实本质上仍然离不开markdown的支持,学会基本的markdown语法,能够摆脱编辑器的限制,在任意情况下输出一篇精美的博文。

标题

markdown使用​#来标记标题,​#​后的文字就是标题内容,有几个​#​就是几级标题。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

列表

markdown使用​-​、​1.​、​*​,来标记列表,记号与内容之间需加一个空格或制表符。

- 文本1
- 文本2

1. 文本1
2. 文本2

* 文本1
* 文本2

链接
--

markdown支持插入链接、文本超链接、网络图片。

www.tencent.com
[腾讯](www.tencent.com)
![](http://imgcache.qq.com/ac/www_tencent/zh-cn/images/sitelogo_zh-cn.gif
也可以设置链接变量
[tencent]:http://imgcache.qq.com/ac/www_tencent/zh-cn/images/sitelogo_zh-cn.gif
![][tencent]

引用

需要引用内容时,只需要在段首添加​>​即可。

>以下是引用内容
> Steve Jobs quoted the farewell message placed on the back cover of the 1971 edition of the Whole Earth Catalog: "Stay hungry. Stay foolish.

表格
--

markdown的表格以​|​、​-​来标记表格的分隔线,​:​来标记对其方式。

First Header | Second Header | Third Header
------------ | :-------------: | ------------:
target | target2 | targert3 
action | action2 | action3 


特殊文字


markdown使用 ​*X*​、​**X**​来分别标记斜体与粗体内容,用~~X~~​来标记划掉的文字,用X``来标记行内代码,X来标记代码段。

*斜体*
**粗体**
~~strikeThrough~~
`inlineCode`

code graph
define something


markdown是由一个Per脚本完成向HTML的转换的,所以在markdown文件中直接书写HTML也是可以的,比如:

<s>strikeThrough</s>
<q>quotes</q>

任务表


这个比较实用,使用​[ ]​、​[x]​来标记是否完成,也可以自己加一些修饰​-[ ]​。

- [ ] task one not finish
- [x] task two finished

LaTeX

markdown支持LaTeX排版,所以支持更丰富的内容展示。

$$x = {-b \pm \sqrt{b^2-4ac} \over 2a}$$ 
this is an inline Level $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$ formula.
\\[ \frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} =
1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}}
{1+\frac{e^{-8\pi}} {1+\ldots} } } } \\]

写内容后,直接将markdown文件的内容粘贴到支持markdown的博客编辑器中,就能生成一篇高质量的博文了!

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

推荐阅读更多精彩内容