美文网首页
markdown语法小记

markdown语法小记

作者: Cassie_Lala | 来源:发表于2019-01-30 10:07 被阅读0次

    原文查看可点击《markdown语法小记》哦!

    基本语法

    标题

    h1~h6对应: #数量决定标题等级。还可以用=在文字下表示,但局限只有两级。

    # h1
    ## h2
    ### h3
    #### h4
    ##### h5
    ###### h6  
    一级标题
    ===
    二级标题
    ---
    

    显示如下:

    引用

    > 引用的文字
    >>  引用的文字
    

    大于号越多,引用的层级越多,上述代码显示效果如下:

    引用的文字

    引用的文字

    链接或图片

    [点击跳转至百度](http://www.baidu.com)
    ![图片](http://cassielala.top/images/logo.jpg)
    

    显示效果如下:
    点击跳转至百度
      

    hexo插入本地图片

    使用hexo的时候因为要插入本地图片遇到了问题,特此写来记录,希望能够帮助到大家。

    • 首先将hexo把主页的配置文件_config.yml 里的post_asset_folder:这个选项设置为true
    • hexo目录下执行npm install hexo-asset-image --save
    • 完成后再new新的md文件的时候就能在/source/_posts下找到同名文件夹,将要放的图片丢进去对应的文件夹。
    • md文件中引入的时候使用[图片上传失败...(image-3c7d69-1548813573167)]即可

    本来到这里应该就万事大吉了,但是嘞,我的图片依旧无法显示,后来经过我一系列的搜索,终于找到了问题的解决方案。
    问题:
    图片依然无法显示的原因是hexo3版本更新后对很多插件支持有问题,hexo-asset-image插件在处理data.permalink链接时出现路径错误,把年月去掉了,导致最后生成的路径为%d/xxx/xxx
    做法:

    • 找到插件hexo-asset-image,通过判断当前版本是否等于3的版本做不同的路径分割,一般插件在/node_modules/目录下。
    • 修改代码如下:
    //可在方法上添加该变量
    var version = String(hexo.version).split('.');
    //修改“data.permalink”
    var link = data.permalink;  
    if(version.length > 0 && Number(version[0]) == 3) 
        var beginPos = getPosition(link, '/', 1) + 1; 
    else 
        var beginPos = getPosition(link, '/', 3) + 1;
    
    • md文件使用时直接写照片名即可。
    • 修改完成保存,重新生成静态文件即可:[图片上传失败...(image-8401ef-1548813573167)]

    列表

    • 无序列表使用*+-标识
    • 有序列表使用数字加.标识,例如:1.
    • 可嵌套使用,回车+tab即可
    * 黄瓜
    * 玉米
    * 茄子
    
    + 黄瓜
    + 玉米
    + 茄子
    
    - 黄瓜
    - 玉米
    - 茄子
    
    1. 黄瓜
    2. 玉米
    3. 茄子
    
    - 黄瓜
      - 水果黄瓜
      - 小黄瓜
    - 玉米
      - 紫玉米
      - 黄玉米
    - 茄子
    

    效果如下:

    • 黄瓜
    • 玉米
    • 茄子
    1. 黄瓜
    2. 玉米
    3. 茄子
    • 黄瓜
      • 水果黄瓜
      • 小黄瓜
    • 玉米
      • 紫玉米
      • 黄玉米
    • 茄子

    <font color="#a00">注:</font>

    • 如果在单一列表项中包含了多个段落,为了保证渲染正常,*与段落首字母之间必须保留四个空格。
    • 如果在列表中加入了区块引用,区域引用标记符也需要缩进4个空格

    反正记住一个原则,如果在和列表配合使用的时候出现了问题,就缩进一次,四个空格或者一个制表符代表一次缩进。如果一次缩进没有解决问题,那就两次。

    分割线

    使用*-即可

    ***
    ---
    

    效果如下:



    强调

    *这里是斜体*
    _这里是斜体_
    
    **这里是加粗**
    __这里是加粗__
    

    效果如下:
    这里是斜体
    这里是斜体
    这里是加粗
    这里是加粗

    插入代码块

    使用两排的“```”包裹就好了。如果需要定于语言高亮,在第一排的三个“`”后面加上名称即可。markdown支持的高亮语言可见下文。

    \```java
    XXXXXX
    ```\
    

    插入表格

    其中第一行表头,第二行定义排列方式,:--坐边即左对齐,居右则右对齐,两边都有则居中。

    表头|条目一|条目二
    :---:|:---:|:---:
    项目|项目一|项目二
    

    效果如下:

    表头 条目一 条目二
    项目 项目一 项目二

    符号处理

    转译多加一个/

    \   反斜线
    `   反引号
    *   星号
    _   底线
    {}  花括号
    []  方括号
    ()  括弧
    #   井字号
    +   加号
    -   减号
    .   英文句点
    !   惊叹号
    

    支持高亮语言

    名称 关键字 名称 关键字
    AppleScript applescript ActionScript 3.0 actionscript3, as3
    Shell bash , shell ColdFusion coldfusion,cf
    C cpp , c C# c# , c-sharp , csharp
    CSS css Delphi delphi , pascal , pas
    diff&patch diff patch Erlang erl , erlang
    Groovy groovy Java java
    JavaFX jfx , javafx JavaScript js , jscript , javascript
    Perl perl , pl , Perl PHP php
    text text , plain Python py , python
    Ruby ruby , rails , ror , rb SASS&SCSS sass , scss
    Scala scala SQL sql
    Visual Basic vb , vbnet XML xml , xhtml , xslt , html
    Objective C objc , obj-c F# f# f-sharp , fsharp
    xpp , dynamics-xpp R r , s , splus
    matlab matlab swift swift
    GO go , golang

    大致介绍就到这里啦,如果有什么新的发现,我会继续更新哒!

    相关文章

      网友评论

          本文标题:markdown语法小记

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