初学MarkDown

210 阅读5分钟

  本人于2019.7.4入职,职位是Java开发。写文章的初衷是记录自己的成长之路,我尝试着记录求职过程中的点滴和一些技术相关的知识。我希望我能坚持写,虽然这只是开始。

  多年后,翻阅这些文章就能清晰的看到自己的成长轨迹。第一次写,首先就得学习MarkDown语法,本文参考了教程-Markdown

Markdown语法

  为什么写语法,网上不是一搜就有详细的吗?我写这个只是为了让自己熟悉语法,熟能生巧!

  首先就是首行缩进,首行缩进由三种方式(参考的网上的其他博客)

  1.   
    

 这是效果

这是效果

  1.   
    

 这是效果

这是效果

  1.   
    

 这是效果

这是效果

  可以看到第二个是最符合的,反正我用的是第二种方式。


  其次是标题,列表(有序和无序)。

  标题就比较简单了,一共有六级标题。在首行插入1至6个#,对应1到6级标题。

# 一级标题(#之后有空格)
## 二级标题(依次类推)

  接着是列表

  无序列表(快捷键:Ctrl+Shift+L)

  使用"-","+","*"都可以,效果都是一样的。

* 无序列表(一级)
    *无序列表(二级)
        *无序列表(三级)
二级按一次tab键,三级两次tab键即可。
  • 无序列表
    • 无序列表(二级)
      • 无序列表(三级)
  有序列表

  直接数字紧接英文句号。

1. 有序列表
2. 有序列表
3. 有序列表

效果:

  1. 有序列表
  2. 有序列表
  3. 有序列表

  代码区块

插入代码快捷键:Ctrl+Shift+C

四个空格或是一个制表符就可以了。

  分割线

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

***
****
---
- - - 
_ _ _

  链接(快捷键:Ctrl+K)

  Markdown 支持两种形式的链接语法: 行内式和参考式两种形式。 不管是哪一种,链接文字都是用 [方括号] 来标记。

  行内式的链接

  要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号(单引号、括弧)把 title 文字包起来即可。

这是[百度](http://www.baidu.com "行内式的链接")链接

这是百度链接,鼠标移动至百度会显示“行内式的链接”几个字,这就是title的作用。

  参考式的链接

  参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:

这是[百度][网址] 的链接.

  接着,在文件的的任意处可以定义标记的链接内容。

[网址]: http://www.baidu.com/  "参考式的链接"

  链接内容定义的形式为:

  • 方括号(前面可以选择性地加上至多三个空格来缩进),里面输入链接文字
  • 接着一个冒号
  • 接着一个以上的空格或制表符
  • 接着链接的网址
  • 选择性地接着 title 内容,可以用单引号、双引号或是括弧包着

效果:

这是百度的链接.

  隐式链接

标记功能让你可以省略指定链接标记,这种情形下,链接标记会视为等同于链接文字,要用隐式链接标记只要在链接文字后面加上一个空的方括号,如果你要让 "Baidu" 链接到 Baidu.com,你可以简化成:

[Baidu][]

接着定义链接内容

[Baidu]: http://www.baidu.com

隐式参考式链接范例:

搜索引擎有[Google][],[Baidu][]等。

[Google]: http://google.com "Google"
[Baidu]: http://www.baidu.com

效果:

搜索引擎有Google,Baidu等。

参考式的链接其实重点不在于它比较好写,而是它比较好读,使用 Markdown 的参考式链接,可以让文件更像是浏览器最后产生的结果,让你可以把一些标记相关的元数据移到段落文字之外,你就可以增加链接而不让文章的阅读感觉被打断。

我觉得参考式的链接的一大好处就是可以复用。


  强调

Markdown 使用星号(*)和底线(_)作为标记强调字词的符号,被 * 或 _ 包围的字词会被转成用 <em> 标签包围,用两个 * 或 _ 包起来的话,则会被转成 <strong>

*强调*
_强调_
**强调**(快捷键:Ctrl+B)
__强调__

效果:

强调
强调
强调
强调

强调也可以直接插在文字中间,如果你的 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号。

如:

这是**强调**和这是** 强调 **。

效果:

这是强调和这是** 强调 **。

如果要在文字前后直接插入普通的星号或底线,你可以用反斜线:\*\_插入普通星号、底线\*\_

效果:

*_插入普通星号、底线*_


  图片(快捷键:Ctrl+Shift+I)

Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。

行内式的图片语法:
![img1](https://p1-jj.byteimg.com/tos-cn-i-t2oaga2asx/gold-user-assets/2019/7/7/16bcbb93757a1b7f~tplv-t2oaga2asx-image.image)    
![img2](https://p1-jj.byteimg.com/tos-cn-i-t2oaga2asx/gold-user-assets/2019/7/7/16bcbb9376eca554~tplv-t2oaga2asx-image.image "柯基")

详细叙述如下:

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

效果:

img1:

img1
img2:
img2
柯基

参考式的图片语法:
![java][url]    
[url]: https://p1-jj.byteimg.com/tos-cn-i-t2oaga2asx/gold-user-assets/2019/7/7/16bcbc744b05f327~tplv-t2oaga2asx-image.image "java"

效果:

java
java

目前,markdown还无法指定图片的宽高,若需要,我们可以使用<img>标签

<img src="https://p1-jj.byteimg.com/tos-cn-i-t2oaga2asx/gold-user-assets/2019/7/7/16bcbc744b05f327~tplv-t2oaga2asx-image.image" width="200px" height="100px"><img/>


Markdown的基本语法差不多就这样了,以后要是用到新的语法再补充吧。我就这样写完了我的第一篇文章,俗话说完事开头难,开了这个头,我希望我能坚持写下去。