使用markdown编写技术博客

使用markdown编写技术博客

  相信很多朋友和我一样有这样的学习经历,想要学习markdown马上从网上找到一些很详细的教程,按部就班从标题设置开始学到区块、表格,学的仔细的同学甚至一些html元素、数学公式都云里雾里的摸了一遍,但是一段时间后,当我们想要写点东西的时候却发现很多东西又不记得了。直到我真的写了一篇技术博客以后,才发现markdown并不需要专门去下功夫学习,就像大家用word写文档设置格式一样,这些技巧就自然的发生了。

  在开头段落中,用到了两个常用的markdown技巧,一是换行,二是首行缩进。当然还有如何表示标题,这个相信大家都会。

注:为避免歧义下文中的双引号均不作为符号的一部分,只是为更清晰的界定符号内容。

1. 换行

  换行有多种方式,但考虑到书写稿的清晰,我喜欢用html的标签“<br/>”,word中一个回车解决的事,也没必要搞得太复杂。

2. 首行缩进

  首行缩进也有多种写法,写博客的时候往往采用中文缩进两个字符,很自然的“&emsp;“符号可以缩进两个空格也就是一个汉字宽度,就很好用。如果是英文”&ensp;“符号表示缩进一个空格也是有用的。

  写到这里,细心的朋友会发现我们又用到了三个技巧,一是列表,“1.换行”、“2.首行缩进”不光是标题还有列表编号,二是markdown符号的转义,三是“注:”这一行用到的区块。

3. 列表

   类比于我们熟悉的word文档编写,列表的作用就是表达多层标题,形式上有有序号列表和无序号列表两种。有序列表的样式就像本文的小标题,以“1. ”,“2. ”,“3. ”来表示(注意符号后有空格),最符合我们熟悉的文档书写习惯;无序列表用“* ”、“+ "、”- “三者之一表示即可(注意符号后有空格),效果是一样的,如下所示。

  • 星号表示
  • 加号表示
  • 减号表示

4. markdown符号转义

   在书写“&emsp;“符号时,发现直接打出该符号,在实际的文章中并不能看到,markdown解释器将其解释为两个空格,想把这个符号打出来需要在其前面加一个斜杠“\”,也就是说我在写markdown文档时将“&emsp;“符号写成了“\&emsp;”。

5. 区块

  区块很简单就是在一行前面加上">"符号,目的就是为了框上一些内容,显得有层次感好看.

  写到这里其实markdown的常用功能已经用的差不多了,但是只是用这些东西,写出来的文章样式过于呆板,不好看就没有吸引力,这也是很多人初学者不愿意采用markdown写东西的原因之一。其实markdown本身可以嵌入html、css等样式,在书写完成后用一些样式点缀一下文章的效果更好。

6. 字体和颜色

  这里用到两个css属性,一是全文字体字号,加在文章开头,将文章字体调整为宋体,字号16;二是“注:”这一段的颜色和字号,调整为灰色,字号14。

  • <body style="font-family:宋体;font-size:16px;" >
  • <div style="color:grep;font-size:14px;" >注:为避免歧义下文中的双引号均不作为符号的一部分,只是为更清晰的界定符号内容。</div>

7. 代码块

  今天要讲的最后一条就是字体颜色一条中用到的代码块,使用方式很简单用两个“```”符号包裹即可。

总结

  今天用一篇文章的方式向大家简要介绍了用markdown书写文章的技巧,希望对大家有帮助。后续随着笔者使用经验的丰富,会陆续给大家更新更多markdown书写技术博客的相关技巧。文章书写仓促,有不足和疏漏之处望指正,谢谢阅览!

  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值