美文网首页写作从学好Markdown开始markdownMarkdown
Markdown的一些心得(适合初学者)

Markdown的一些心得(适合初学者)

作者: 写代码的海怪 | 来源:发表于2017-02-07 15:27 被阅读2450次

    孰能生巧

    写在前面

    简洁,是普罗大众所追求的一种精神。当我在编写文档的时候,当时还是用Windows系统,用Word编写文字觉得很不简洁。而现在Markdown的出现给很多作者一个非常棒的写作工具。之前想装逼去学 Latex ,发现不如Markdown简单易懂,其中需要很多命令和代码来堆叠,而且对于 正常写作的人 来说不是一个非常好的选择。而Markdown则是一个很容易上手的工具。

    后来看了一下网上的(基本就是简书吧),教程都是很专业,很系统,但是觉得不太适合初学者。里面罗列了很多知识包括HTML的代码实现和Markdown的工作原理。我是一个程序猿嘛,我知道初学者一般都想: 你说这么多,都不敲代码,说个鬼啊。所以我在这里我不想讲这些,我想通过举例子来让你了解Markdown的基本语法。而这些语法保证可以够你完成 99.9% 的工作。

    这里有人问了怎么在简书上写Markdown,简书默认是使用“富文本”形式的编辑器,说白了就是非Markdown嘛。设置到Markdown编辑器再将你写好的内容复制到上面去就好了。参考这里设置你的简书为Markdown编辑器

    目录

    • 写Markdown的工具
    • 基本知识
    • 实践运用
    • 结尾

    写Markdown的工具

    工欲善其事,必先利其器

    作为初学者首先需要知道我们最好别用txt来写Markdown,承认有些人为了装逼会用txt来写代码...我这里推荐 Atom。这里为了照顾不同操作系统的你,不要有编辑器门户之争!当然Mac下使用Macdown或者Mou也挺好。

    Atom

    Atom官网:点击去往Atom官网。点进去之后会看到一个大大的 Download 按钮的啦。

    大大的Download

    一步步安装,打开Atom。事实上Atom会自带Markdown的插件的,但是不知道为什么我的不行。所以得去下载一个插件:<mark>Markdown-Preview-Plus</mark>。下面是安装插件的具体步骤:

    1.找到“设置”(cmd+, | win下在左上角的菜单栏就有了)

    找到“设置”

    2.点进“install”,点进去输入 Markdown-Preview-plus 搜索,出现第一个点击“install”,我这边已经装了所以就没有install了,看下一个插件就有“install”了。

    安装Markdown-Preview-plus插件

    3.然后点进Packages里面,搜索mark,把Markdown-Preview进行disable操作。

    disable.png

    3.拖进一个文件夹到Atom中,并在这个文件夹下面创建一个 test.md 文件,md就是Markdown缩写嘛。注意:一定要有后缀名哦~。

    4.打开这个Markdown文件,试试在里面输入一些文字啥的。哎,感觉没反应是不是?现在Cmd+Shift+p(Win下Ctrl+Shift+p),在输入框中输入markdown,选择“markdown preview plus:toggle”回车就好。

    然后会出出现两个屏。在第一个屏里面输入下面文字。

    ###### hello world
    # hello world
    

    如果产生下面效果,那么说明你完成了配置:
    ![Uploading test_394032.png . . .]

    成功配置

    其实呢,我们下的Atom仅仅是个编辑器,需要一些插件来帮助我们显示markdown的预览。而我下载的那个插件就是为了预览的。事实上不下载那个插件也是可以的,建议先从第3步开始看,不知道是不是我电脑的问题我不能用Atom自带的插件。

    基本语法

    搞了那么久终于开始学习语法了。其实Markdown的本意就是为了简洁你的写作,所以别有太大的心里负担。后面我会给个小小例子来帮助大家一起实践。现在打开刚刚创建的test.md文件一起跟着我练习吧。

    1.字体大小

    输入如下

    ###### hello world
    ##### hello world
    #### hello world
    ### hello world
    ## hello world
    # hello world
    

    展现效果:

    hello world
    hello world

    hello world

    hello world

    hello world

    hello world

    注意:这里只有1~6个#号,7个就不行了,不信试试。

    2.引用块

    输入如下:

    > 您的好友已上线
    > > 黑百合报道
    > > 半藏报道
    > > > **这游戏还能不能玩了?**   (此处有三个空格哦~否则不换行)
    > > > **感觉队伍少了两个人**
    

    展示效果

    您的好友已上线

    黑百合报道
    半藏报道

    这游戏还能不能玩了?
    感觉队伍少了两个人

    3.强调

    输入如下

    **Strong** *Lean*
    
    __Strong__ _Lean_
    

    展现效果

    Strong Lean

    Strong Lean

    注意:对,你没看错,两种效果一样的,选一个就行。

    4.图片

    首先放一张图到这个目录下,与test.dm同级的,嗯,叫test.png吧。

    输入如下:

    ![](test.png)
    ![MacDown logo](http:https://img.haomeiwen.com/i2979799/9e844c1c9daf991c.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
    

    展示效果

    Test图片滴 MacDown logo

    一种本地图片,一种网上图片。格式为:![](图片路径)。在Atom上貌似不能显示图片下标,但是在简书上面是可以的。还有,写简书的人要注意了:如果你引用本地图片写文章,在简书编辑器上面一定要将图片拖拽到简书的编辑器上面,否则本地文件简书怎么获取啊。

    5.超链接

    输入如下

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

    展示效果

    Baidu

    这个就不用解释了吧,吧感叹号去掉就变成超链接了。

    6.显示代码

    输入如下

    ~~~java
      public void hello();
    ~~~
    
    ```java
      public void hello();
    ```
    

    展示效果

      public void hello();
    
      public void hello();
    

    没错,又是两种都行,随便挑一个。需要注意的是:可以在一开始显示需要高亮哪种语言风格,我这里就用java了,你可以试试xml,html,c都是可以的。

    7.表格

    输入如下

    First Header  | Second Header
    ------------- | -------------
    Content Cell  | Content Cell
    Content Cell  | Content Cell
    
    You can align cell contents with syntax like this:
    
    | Left Aligned  | Center Aligned  | Right Aligned |
    |:------------- |:---------------:| -------------:|
    | col 3 is      | some wordy text |         $1600 |
    | col 2 is      | centered        |           $12 |
    | zebra stripes | are neat        |            $1 |
    

    展示效果

    First Header Second Header
    Content Cell Content Cell
    Content Cell Content Cell

    You can align cell contents with syntax like this:

    Left Aligned Center Aligned Right Aligned
    col 3 is some wordy text $1600
    col 2 is centered $12
    zebra stripes are neat $1

    看看冒号在哪,就往哪对其。

    8.分割线

    输入如下

    ---

    展示效果

    3个短横线就够了,你写100个也是可以的。

    9.分点

    输入如下

    1. One
    2. Two
    3. Three
    

    展示效果

    1. One
    2. Two
    3. Three

    注意在小数点的后面需要一个空格哦

    实践运用

    学了一点点知识,想记住他就多打打字就能记住了。所以我提供两个.md文件给大家练习,大家可以看看里面的内容,照着内容写一下,多练练。第一个是我写的一个Spring的基本笔记,第二个是MacDown官网上的Markdown帮助手册。

    参考实例:Spring的基本笔记

    参考实例:Macdown参考手册

    结尾

    是不是觉得知识都很少?没错,就是很少的,这些基本知识可以应付99.9%的写作了。如果要更多(其实也没多少)技巧,可以参考Macdown参考手册(实践运用的第二个链接,虽然是英文版的,但是你看效果就知道发生了什么)。

    当然了,如果知道怎么写Html代码的同学,也是可以往这Markdown文件里面标签的,例如:<mark>嘿嘿嘿</mark>就变成<mark>嘿嘿嘿</mark>`

    还有一些换行规则的,例如直接换行是换不了行的。可以试试空格空格空格+换行来进行软换行,而换行+换行则是硬换行。通俗点就是文章换行时候是不是会多出一个大空白的地方

    好了,到最后希望大家可以一起进步吧,多巧文字,慢慢学会Markdown。

    \^O^/

    相关文章

      网友评论

      • 老衲法号能吃:请问所有的编程语言都支持么? 我用python貌似不行
        写代码的海怪:@老衲法号能吃 这个可以的呀你复制一下这个文本看看:
        ```python
        print ('Hello World')
        ```
        老衲法号能吃:@hai_guai 我是说markdown有对python的特效支持么。java我试过是有的,python我没试出来。。— —,难道是我打开的方式不对?
        写代码的海怪:@老衲法号能吃 你是说不能用atom写python?我之前就用atom写python的呀,也没有装什么插件0.0
      • 花布罗陀:空格怎么实现呀
        写代码的海怪: @花布罗陀 直接空格即可,但是多个空格会变成一个空格.。一般写作不需要多个空格吧😂
        写代码的海怪:@花布罗陀 不太懂?你是指两个字之间的空格么?
      • 张晓衡:请问简书怎么用markdown呢?
        写代码的海怪: @danniszhang 没事😜,这个我开始也不懂,后来百度上查到的😂
        张晓衡: @hai_guai 写了好几篇一直没找到方法,谢谢你。
        写代码的海怪:@danniszhang 这个需要设置的,点开你的头像就会有一个设置,在常用编辑器里面选择Markdown,默认是富文本。然后你把在编辑器写好的东西直接复制到上面去就好了。不过一旦选择了Markdown之后就都是用Markdown来写文章了,想转换回原来的形式就选富文本就好了。

      本文标题:Markdown的一些心得(适合初学者)

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