美文网首页简书指南实用学习技能工具装备
献给写作者的 Markdown 新手指南

献给写作者的 Markdown 新手指南

作者: 简书 | 来源:发表于2013-04-22 22:02 被阅读796570次

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

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

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

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

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


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

    标题

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

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

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

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

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

    一级标题至六级标题

    列表

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

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

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

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

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

    列表案例截图如下:


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

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

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

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

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

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

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

    引用

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

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

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

    最终显示的就是:

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

    引用的案例截图:

    粗体和斜体

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

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

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

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

    粗体和斜体的案例截图:

    代码引用

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

    表格

    相关代码:

    | 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 的优雅之处!

    最后,希望我们的指南可以帮助到您,也希望「简书」能够成为您书写 Markdown 的最佳选择。

    相关文章

      网友评论

      • MOVE1925:显示引号的那种引用在简书无法实现?
      • 观察者_王动:期待latex 的讲解。
      • 蓝风J:友情提醒:发现登录简书以后,需要在个人账号设置里面 先选择 常用编辑器 为 “markdown”,才可以正常新建和编辑文件。:smile:
      • Youngcanwen:最后的代码是什么意思?
      • Lonie233:能上传写好的吗?
      • 半株七绝草:简书如果可以添加背景音乐就更好了
      • 奶茶小丸:为什么有的段落另起一行空格后,字会出现在方框里?
      • 现代愚公BevisWu:markdown不支持流程图,好伤心
      • DontDD:插入视频怎么弄?

      • 木子影:引用结束的标识是什么,用了一个>之后,后面的文字还是引用
      • MiBoy:现在的简书编辑器为什么没有了预览了呢
      • 指尖书法:出现一个bug,在有序列表中插入表格后, 继续书写会出现有序列表的序号重新排列的现象,而且在网上也找不到合适方法解决.
      • COLA婷:作为中文写作者来说,在使用markdown的时候需要中英文输入法切换,也是很麻烦的啊
      • moming1314:怎么画分割线??
      • 吃蘑菇De大灰狼:请问可以支持Task List吗? - [ ]任务列表不生效啊。
      • NG524:简书现在不能预览了?
      • 蜗牛笔耕:不错,实用性强!
      • 熊猫duoduo:如何能运用“$$y=x^2$$”这种公式呢,目前直接输入出不来
      • 丁木木木木木:有添加目录的方法么:grin: :grin:
      • 哇哦小科技:请问怎么居中呢
      • 千寻爱妈妈:简书做的也太不智能了吧!!!!!!!!!!!
      • 云天大侠_general: 简书的Markdown 编辑器没有快捷键吗?感觉这样写作慢了不少啊!要是有快捷键就更好了。
      • 漫极光:怎么保存?只保存不发表?
      • 啥也不说了:可以生成目录吗?
      • 王小漂:这个简介简洁快速高效,Ni值得拥有。
      • YY17:@简叔,为何这里的markdown不支持时序图和流程图的语法
      • 27f08b31439e:对新手很友善
      • 野性浮云:感觉好难,富文本的介绍谁找到了,给个链接
      • 龙少侠linux:能不能提供下字体颜色设置呢。
      • 梦蓝樱飞2020:很不错, 谢谢啦!
      • Vera24:上传后的图片怎么改尺寸,我在GitHub里可以修改的。用同样的方法在简书里不行
      • 和坚:支持latex公式吧,支持latex公式吧,支持latex公式吧
      • niunan:fcrf 支持支持支持
      • niunan:为什么我这里没有 那个预览模式啊?
      • 艾大叔:厉害了我的哥!
      • 03433671a77a:预览页面自动滚动功能没有?
      • 荒原苍狼:这是个好东西。值得试一试。
      • 水哥叔叔:简书的markdown好像不能原生支持LaTex语法:persevere:
      • lynch0571:很赞!已收录《千赞专题》,欢迎关注:http://www.jianshu.com/collection/032a478c3dbf
      • 8d8de2ac4dfe:添加一个吧 删除线是~~无效内容~~实现的
      • fb4eda6b1bcd:为什么我在设置里切换成了markdown编辑器,在新建文章的时候还是富文本?想试一下简书的冲动又被压下去了。。。
      • 小小棒棒糖:简书不支持markdown目录跳转吗?做了[XXXX](#标题) <span id="jump">Hello World</span>不跳转
      • 梓木心:介绍的挺详细的,有帮助
      • 职场惠客厅:毫不犹豫奔向markdown:heartbeat:
      • _和咸鱼没什么区别:“将您的编辑器切换至 Markdown 编辑器,”请问我在哪儿切换我的编辑器呢?:no_mouth:
        _和咸鱼没什么区别:已解决,谢楼主的用心分享!
      • DANIKE:![][1]
        [1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)+1
        这个为什么老是显示不出来
      • 大漠狼道:markdow是用的那个版本的?commonmark还是别的?
        支持named anchor么?
      • 兽小喵:为什么我切换到这个模式之后,下作板式并没有改变呢 :flushed:
      • 影子的花花影子:如果插入的图片是自己的截图来的,没有链接,怎么办
      • 767acde222c9:简书的makedown 里怎么显示红色字体
      • 橙一升:一直使用的不熟悉…这次可以好好研究下了
      • cherry_liulei:为什么定义流程图预览没有生成图?
      • 狐小霓:求解如何插入动图,还有钥匙插入视频的话是要上传吗 :joy:
      • 孤单让我不快乐:简书的markdown支持语法太喽了!~~~~~~~~~~~~~~~~~~~~~~~~~
      • i诺离:可以上传除了图片的文件吗
      • 民族融合:为什么我的电脑下载简书很慢,且没法安装
      • 一块积木:Markdown就是因为简单,所以流行,但是也是因为简单,表现力太差。
        建议你们丰富实用Markdown的模板,让大家来使用,反正Markdown的解释都在你们的引擎上。。。
      • lemonade_:不是太能看懂呀 :relieved:
      • 不惜留恋_:矩阵如何表示 ?
      • 鱼f:好不错,正需要这个呢
      • 苍蝇的梦: :cold_sweat:
        已经写了七篇,感觉越写越丑,想着应该是哪里不对,搜了搜,总是找到写作方法了。
        为什么写第一篇的时候没看到这个???
        不应该在显眼处提示一下吗?
        苍蝇的梦:@拾荒者老大 关注,收藏,喜欢都点了,下次不怕找不到了 :smile: ,有空改一下以前的
      • 108N8:写的不错支持一下
      • 小二青宸:为什么有的文章编辑好后可以在主页可以看到图片,有的看不到?图片都是放在最开始的位置。另外markdown怎么加分割线呢
        毅栈:@青宸 - - - -
      • 一行代码解决不了问题那就写两行:简书既然支持了markdown,为什么不支持markdown的快捷键呢,甚至连markdown的排版按钮也没有,使用markdown的作者,都是不自己输入##### ! > 等来控制层次的
      • 锐澳one:怎么做目录的格式
      • real阿苏勒:简书的markdown好像不支持html标签啊,比如没法给文字添加颜色。csdn上就支持。
      • I_Gisvity:@简叔 能不能把这个MarkDown编辑器做成和 CSDN中 博客发表 的那个编辑器一样,带有一些行、字体、图片等按钮的编辑器
      • 853b8d58e9f8:请问本地图片,链接怎么添加?👍
      • 童以默:简书能不能把两种写作模式整合到一起,搞出个第三种写作模式,这样子就更好了,希望可以采纳 :smile:
      • 83aa0f658db7:没搞明白方便再哪里,本来写字排版就行了,用markdown还得记代码。有种从windows回到dos的感觉。我再研究研究 :stuck_out_tongue_winking_eye:
      • 16bb8efb929d:做做笔记,写些不长的文档,Markdown还算不错;但要写比较长的篇章,对格式有一定要求的,Markdown不一定合适。我若是写比较注重的文档,宁愿稍微麻烦点去用LaTeX。
      • Aecu:不支持<font size=5>这样的字体设置么
      • 糖纸疯了:感觉太麻烦了,我写了一篇博文,用了半小时来回倒,对照格式编辑
      • Winfred吴佳:小编这个地方改一下:
        加粗体那个,我试了一下
        要**文字**才可以!
      • YangEric:要用它写作,正好学习下
      • Wind教口语:提问: 加粗似乎比斜体用的频繁的多的多,为什么加粗是** **, 要敲4下唉
        建议: 目前markdown的模式隐藏的有点深唉, 直接在文章工具栏上提供一个markdown视图模式不可以吗? (就不需要先去设置里边修改为markdown, 回来仍然找不到markdown的预览, 尝试退出重新登录还是不行, 最后尝试新建一篇文章才行, 这个太不友好了)
      • 巴图鲁:原来是这样的,看了对如何编辑稍微了解了一点
      • f034a68b0b09:初入简书的菜鸟mark. 楼主你好,所以简书markdown工具也可作为工作的记事本之用,与印象笔记同理?
      • 随心吧:写的好不错,喜欢
      • _minimal:请问大家手机端的代码框显示的使用,有出现左右滑动不灵敏的情况吗?而且代码框前面部分支持左右滑动,后面部分滑动不了!
      • Petershen:学习中
      • 8870f51a5d10:看不懂感觉:scream::scream:
      • 紫气东来__:怎么导出pdf文档
      • itachi:话说这个字体颜色 怎么改,我弄了下 <font color=gray size=72>color=gray</font>这个貌似不起作用呀
      • 557ea5f6ef94:遇到问题了,怎么写 <b> ?直接写会将后面的字变成粗体,本来想到用反斜杠来说明,但输出效果是 \<b\>,怎么办?
      • 806884474e79:MarkDown不是天然支持公式的嘛
      • Dddddw:简书的markdown无法支持数学方程式的书写?
      • 5dea60f43ab1:win 10 上的新手建議
        typora + pandoc
        安裝到使用"完全不用打指令",常用的指令先用再學。
        所見及所得、輕量markdown (有簡單的代碼高亮)、圖片拖入即可(不用打路徑)、介面好看
        缺點
        (多數markdown 通病)圖片如果移除文件裡面的圖片也會不見....應該有解決辦法(例如匯出成word or pdf)



      • 豆大大:道理我都懂,为什么不支持<table>??
      • qufl:能不能生成目录呢? 希望有这个功能 :relieved:
      • Lmmmmbbb:建议预览模式下,预览页和编辑页滚动同步~
      • 倘若花落:目录和标签的功能怎么不支持啊

      本文标题:献给写作者的 Markdown 新手指南

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