美文网首页
Markdown 写作 | 新手指南

Markdown 写作 | 新手指南

作者: 木语沉心 | 来源:发表于2019-08-26 16:18 被阅读0次

    「简书」作为一款「写作软件」在诞生之初就支持了 Markdown,Markdown 是一种「电子邮件」风格的「标记语言」,我们强烈推荐所有写作者学习和掌握该语言。为什么?可以参考:

    在此,我们总结 Markdown 的优点如下:

    • 纯文本,所以兼容性极强,可以用所有文本编辑器打开。
    • 让你专注于文字而不是排版。
    • 格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。
    • Markdown 的标记语法有极好的可读性。

    当然,我们既然如此推崇 Markdown ,也必定会教会你使用 Markdown ,这也是本文的目的所在。不过,虽然 Markdown 的语法已经足够简单,但是现有的 Markdown 语法说明更多的是写给 web 从业者看的,对于很多写作者来说,学习起来效率很低,现在,我们特地为写作者量身定做本指南,从写作者的实际需求出发,介绍写作者真正实用的常用格式,深入浅出、图文并茂地让您迅速掌握 Markdown 语法。

    为了使您更好地学习,我们建议您登录[「简书」](http://www. jianshu.com),将您的编辑器切换至 Markdown 编辑器,新建一篇空白笔记,然后点击右上角的预览模式:

    image

    此时,您的界面应当如下图所示,左侧为编辑区域,右侧为预览区域,您在左侧输入 Markdown 语法的文本,右侧会立即帮您呈现最终结果,好了,让我们开始学习吧~

    image

    标题

    这是最为常用的格式,在平时常用的的文本编辑器中大多是这样实现的:输入文本、选中文本、设置标题格式。

    而在 Markdown 中,你只需要在文本前面加上 # 即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加 # 即可,标题字号相应降低。例如:

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

    注:# 和「一级标题」之间建议保留一个字符的空格,这是最标准的 Markdown 写法。

    你可以你的编辑器中尝试输入这六级标题,可以参考下方的截图:

    image

    列表

    列表格式也很常用,在 Markdown 中,你只需要在文字前面加上 - 就可以了,例如:

    - 文本1
    - 文本2
    - 文本3
    
    

    如果你希望有序列表,
    也可以在文字前面加上 1. 2. 3. 就可以了,例如:

    1\. 文本1
    2\. 文本2
    3\. 文本3
    
    

    注:-1.和文本之间要保留一个字符的空格。

    列表案例截图如下:

    image

    <h2 id="picture"> 链接和图片</h2>

    在 Markdown 中,插入链接不需要其他按钮,你只需要使用 [显示文本](链接地址) 这样的语法即可,例如:

    [简书](http://www.jianshu.com)
    
    

    在 Markdown 中,插入图片不需要其他按钮,你只需要使用 [图片上传失败...(image-8f5527-1566807431343)] 这样的语法即可,例如:

    ![](https://img.haomeiwen.com/i259/0ad0d0bfc1c608b6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
    
    

    注:插入图片的语法和链接的语法很像,只是前面多了一个

    插入链接和图片的案例截图:

    image

    引用

    在我们写作的时候经常需要引用他人的文字,这个时候引用这个格式就很有必要了,在 Markdown 中,你只需要在你希望引用的文字前面加上 > 就好了,例如:

    > 一盏灯, 一片昏黄; 一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
    
    

    注:> 和文本之间要保留一个字符的空格。

    最终显示的就是:

    一盏灯, 一片昏黄; 一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

    引用的案例截图:

    image

    粗体和斜体

    Markdown 的粗体和斜体也非常简单,用两个 * 包含一段文本就是粗体的语法,用一个 * 包含一段文本就是斜体的语法。例如:

     *一盏灯*, 一片昏黄;**一简书**, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。
    
    

    最终显示的就是下文,其中「一盏灯」是斜体,「一简书」是粗体:

    一盏灯, 一片昏黄;一简书, 一杯淡茶。 守着那一份淡定, 品读属于自己的寂寞。 保持淡定, 才能欣赏到最美丽的风景! 保持淡定, 人生从此不再寂寞。

    粗体和斜体的案例截图:

    image

    代码引用

    需要引用代码时,如果引用的语句只有一段,不分行,可以用 ` 将语句包起来。
    如果引用的语句为多行,可以将```置于这段代码的首行和末行。
    代码引用的案例截图:

    image

    表格

    相关代码:

    | Tables        | Are           | Cool  |
    | ------------- |:-------------:| -----:|
    | col 3 is      | right-aligned | $1600 |
    | col 2 is      | centered      |   $12 |
    | zebra stripes | are neat      |    $1 |
    
    

    显示效果:

    Tables Are Cool
    col 3 is right-aligned $1600
    col 2 is centered $12
    zebra stripes are neat $1

    <p></p>
    相关代码:

    dog | bird | cat
    ----|------|----
    foo | foo  | foo
    bar | bar  | bar
    baz | baz  | baz
    
    

    显示效果:

    dog bird cat
    foo foo foo
    bar bar bar
    baz baz baz

    <p></p>

    显示链接中带括号的图片

    ![][1]
    [1]: http://latex.codecogs.com/gif.latex?\prod%20(n_{i})+1

    代码如下:

    ![][1]
    [1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)+1
    
    

    结语

    以上几种格式是比较常用的格式,所以我们针对这些语法做了比较详细的说明。除这些之外,Markdown 还有其他语法,如想了解和学习更多,可以参考这篇『Markdown 语法说明』

    强烈建议您现在就立马用 Markdown 写一篇文章吧,体会一下 Markdown 的优雅之处!

    转载至: >>>
    作者:简书
    来源:简书官网
    链接:https://www.jianshu.com/p/q81RER

    相关文章

      网友评论

          本文标题:Markdown 写作 | 新手指南

          本文链接:https://www.haomeiwen.com/subject/vzkdectx.html