目录
  1. 1. 前言
  2. 2. 标题
  • 大标题,内容放在===上面
    1. 1. 中标题,内容放在—上面
  • 一级标题H1
    1. 1. 二级标题H2
      1. 1.1. 三级标题H3
        1. 1.1.1. 四级标题H4
          1. 1.1.1.1. 五级标题H5
            1. 1.1.1.1.1. 六级标题,不能再小了H6
    2. 2. 正文
    3. 3. 强调
    4. 4. 引用
    5. 5. 列表
      1. 5.1. 无序列表
      2. 5.2. 有序列表
      3. 5.3. 嵌套列表
      4. 5.4. 任务待办
    6. 6. 排版
      1. 6.1. 空格
      2. 6.2. 分隔符
      3. 6.3. 对齐
      4. 6.4. 字体
      5. 6.5. 折叠
      6. 6.6. 说点什么
    7. 7. 图片
      1. 7.1. 普通图片
      2. 7.2. 带链接的图片(方法一,图片+链接)
      3. 7.3. 带链接的图片(方法二,引用式)
      4. 7.4. 内部引用图片
      5. 7.5. 控制图片大小及对齐方式
    8. 8. 链接
      1. 8.1. 行内式
      2. 8.2. 参考式
    9. 9. 表格
    10. 10. 代码
      1. 10.1. diff
    11. 11. 脚注
      1. 11.1. 方法一
      2. 11.2. 方法二
    12. 12. 视频
    13. 13. 音频
    14. 14. 地图
    15. 15. LaTeX公式
    16. 16. 流程图
    17. 17. 序列图
    18. 18. 甘特图
    19. 19. 最后是脚注的解释内容
  • markdown教程有这么一篇就够了

    前言

    markdown已被越来越多的互联网厂商支持,如github、有道云、简书、CSDN等,默认都支持md语法。markdown真正做到了排版与文字分离,让你专注在内容本身。

    标题

    大标题,内容放在===上面

    中标题,内容放在—上面

    一级标题H1

    二级标题H2

    三级标题H3

    四级标题H4

    五级标题H5
    六级标题,不能再小了H6
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    ## 标题
    大标题,内容放在===上面
    ===
    中标题,内容放在---上面
    ---
    # 一级标题H1
    ## 二级标题H2
    ### 三级标题H3
    #### 四级标题H4
    ##### 五级标题H5
    ###### 六级标题,不能再小了H6

    正文

    正文,常规文本,不需要任何标识。回车键不能直接换行,只能用以下两种方式。

    1. 两个空格+回车
    2. 用< br>或< br/>

    这是个用例,我要换行了。
    成功换行。
    另一种方式换行。

    也成功了。


    强调

    两个*加粗
    两个_加粗
    一个星号斜体
    一个下划线斜体
    两个~删除线
    三个星号是粗斜体
    下划线

    1
    <u>下划线</u>

    这是高亮显示

    1
    这是`高亮显示`

    上标:X2,下标:O2

    1
    上标:X<sub>2</sub>,下标:O<sup>2</sup>
        hello, i am ajioy! a Tab in head (行首放8个空格)
        something important here 
    

    引用

    块引用
    换行内容

    • 可以加列表

    嵌套引用

    外层引用

    内层引用
    还可以嵌套加粗斜体

    第三级引用

    第四级引用

    1
    2
    3
    4
    5
    > 第一层引用
    > * 第一层引用加列表,行尾2个空格
    > * 第一层引用加列表
    >> 第二层引用
    >>> 第三层引用,依次类推

    列表

    无序列表

    • c++
    • python
    • javascript
    1
    2
    3
    * c++
    - python
    + javascript

    有序列表

    1. apple
    2. orange
    3. banana
    1
    2
    3
    1. apple
    2. orange
    3. banana

    嵌套列表

    • first
      • second
        1. third
        2. third another
    • another one
      • great
        • fantastic
    1
    2
    3
    4
    5
    6
    7
    * first
    * second
    1. third
    2. third another
    * another one
    * great
    * fantastic

    任务待办

    • [x] 跑步
    • [x] 买日常用品
    • [ ] 数据备份
    • [ ] 买菜做饭
    1
    2
    3
    4
    5
    任务待办
    - [x] 跑步
    - [x] 买日常用品
    - [ ] 数据备份
    - [ ] 买菜做饭

    排版

    空格

    • 不断行的空格   或   1/4 中文
    • 半角的空格   或   半个中文,1字符
    • 全角的空格   或   1个中文,2字符
    1
    2
    3
    &nbsp; ---> 牛皮的spa
    &ensp; ---> 嗯,很舒服的spa
    &emsp; ---> 摁(第四声),很大力的spa

    分隔符




    三个减号,三个星号,三个下划线都可以作为分隔符

    对齐

    left

    center

    right

    1
    2
    3
    <p align="left">left</p>  
    <p align="center">center</p>
    <p align="right">right</p>

    字体

    我是黑体字
    我是华文彩云
    color=#0099ff size=5 face=“黑体”
    color=gray

    Size:文本的尺寸大小,可能的值:从 1 到 7 的数字。浏览器默认值是 3
    github不支持

    1
    2
    3
    4
    <font face="黑体">我是黑体字</font>  
    <font face="STCAIYUN">我是华文彩云</font>
    <font color=#0099ff size=7 face="黑体">color=#0099ff size=72 face="黑体"</font>
    <font color=gray size=4>color=gray</font>

    折叠

    点我展开折叠

    说点什么

    • 这是个列表
    • 确实是个列表,你真棒

    一个小小的引用块🤔

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12

    <details>
    <summary>点我展开折叠</summary>

    ### 说点什么

    - 这是个列表
    - 确实是个列表,你真棒

    > 一个小小的引用块🤔

    </details>

    注意:目前只有github支持


    图片

    普通图片

    pic

    1
    ![pic](http://ajioy.cn/img/avatar.jpg "my pic")

    带链接的图片(方法一,图片+链接)

    pic

    1
    [![pic](http://ajioy.cn/img/avatar.jpg "my pic")](https://blog.csdn.net/ajioy)

    带链接的图片(方法二,引用式)

    ![blog]
    [blog]: http://ajioy.cn/img/avatar.jpg “my pic”

    1
    2
    [![blog]](https://blog.csdn.net/ajioy)
    [blog]: http://ajioy.cn/img/avatar.jpg "my pic"

    大部分平台不支持

    内部引用图片

    1
    2
    [![SMILE](_pics/smile.gif)](https://blog.csdn.net/ajioy)
    其中SMILE是标题,_pics是md文件所在目录下的子目录,也是图片所在地,smile.gif则是图片名称

    控制图片大小及对齐方式

    • 方法一,平台通用的标签法
    1
    2
    3
    <div align="right">
    <img src="http://ajioy.cn/img/avatar.jpg" width="400px" height="400px">
    </div>
    • 方法二,部分平台支持
      ![pic](url),其中url后面加个空格,再=WIDTHxHEIGHT,HEIGHT可以省略。
      如 (http://url.jpg =400x400)
    1
    2
    ![pic](http://ajioy.cn/img/avatar.jpg =400x400)
    ![pic](http://ajioy.cn/img/avatar.jpg =400x)
    • 方法三,简书等部分平台支持
    1
    ![pic](url)的基础上加上{:height="300px" width="300px"}

    链接

    行内式

    直接链接1 https://blog.csdn.net/ajioy
    直接链接2 https://blog.csdn.net/ajioy
    带标题链接
    带标题链接且鼠标悬停

    1
    2
    3
    4
    直接链接1 https://blog.csdn.net/ajioy  
    直接链接2 <https://blog.csdn.net/ajioy>
    [带标题链接](https://github.com/ajioy)
    [带标题链接且鼠标悬停](https://blog.csdn.net/ajioy "go to my blog")

    参考式

    [带标题链接][link]
    [link]: https://blog.cdsn.net/ajioy “Blog”

    1
    2
    [带标题链接][link]
    [link]: https://blog.cdsn.net/ajioy "Blog"

    参考式相对于行内式的优点是,可以在多个不同的位置引用同一个URL,图片也可以用此方式


    表格

    序号 名字 分数
    101 ajioy 99.82
    102 scotte 98.12
    103 bot 97.23
    1
    2
    3
    4
    5
    | 序号 | 名字   | 分数  |
    | :--: | :--- | ---: |
    | 101 | ajioy | 99.82 |
    | 102 | scotte | 98.12 |
    | 103 | bot | 97.23 |

    :— 左对齐,冒号在左边
    —: 右对齐,冒号在右边
    :–: 居中对齐,冒号两边

    复杂表格

    目标 计划 说明
    晨跑
    1. 6:30起床
    2. 热身10分钟
    3. 平地跑5公里,约35分钟
    4. 跑后拉伸5分钟
    • 下雨天不跑
    • 上医院不跑
    • 周末不跑
    健康生活 作息6:30-23:00,睡足7.5小时
    • 争取22:30入睡
    • 周末分别顺延30分钟
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    <table>
    <tr>
    <td>目标</td>
    <td>计划</td>
    <td>说明</td>
    </tr>
    <tr>
    <td>晨跑</td>
    <td><ol>
    <li>6:30起床</li>
    <li>热身10分钟</li>
    <li>平地跑5公里,约35分钟</li>
    <li>跑后拉伸5分钟</li>
    </ol></td>
    <td><ul>
    <li>下雨天不跑</li>
    <li>上医院不跑</li>
    <li>周末不跑</li>
    </ul></td>
    </tr>
    <tr>
    <td>健康生活</td>
    <td>作息6:30-23:00,睡足7.5小时</td>
    <td><ul>
    <li>争取22:30入睡</li>
    <li>周末分别顺延30分钟</li>
    </ul></td>
    </tr>
    </table>

    代码

    1
    2
    def add(a, b):      # python
    return a + b
    1
    sudo apt-get install autojump # bash
    1
    2
    3
    4
    int main()
    {
    printf("hello,ajioy"); // cpp
    }

    diff

    1
    2
    3
    4
    5
    + add
    - delete
    ~ modify?
    ! what's this
    # i don't known

    脚注

    方法一

    句中作脚注,解释一个名词[1],再解释一个[2]
    脚注放在文章最下面,脚注可以直接放链接。

    1
    2
    3
    4
    句中作脚注,解释一个名词[^1],再解释一个[^2]。  
    脚注放在文章最下面,脚注可以直接放链接。
    [^1]: 解释名词1
    [^2]: https://www.google.com

    方法二

    整个句子作脚注。[3]
    有道云支持。

    1
    整个句子作脚注。^[这里就是脚注内容,默认会生成脚注序号]

    github不支持以上两种方式,以下为替代方案

    1
    2
    3
    4
    定义
    <a name="myfootnote1">1</a>: Footnote content goes here
    引用
    <sup>[1](#myfootnote1)</sup>

    我要解释一个名词1

    1: Footnote content goes here

    视频

    以B站为例,点分享按钮,复制嵌入代码,粘贴到md文件即可,其他网站类似。

    1
    <iframe src="//player.bilibili.com/player.html?aid=57373164&cid=100164001&page=1" width="600" height="300" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>

    github不支持,用带链接的GIF代替

    音频

    1
    2
    3
    <audio id="audio" controls="" preload="none">
    <source id="mp3" src="http://yourmusicurl.mp3">
    </audio>

    github不支持


    地图

    以百度地图为例,
    访问API自定义地图 http://api.map.baidu.com/lbsapi/creatmap/index.html

    设置好地点、文字、路线、标记后,点获取代码,复制代码,直接放在md文件,或将代码存放在map.html文件,同一目录下,再引入markdown

    github不支持


    LaTeX公式

    todo
    访问 MathJax


    流程图

    todo
    语法参考:流程图语法参考


    序列图

    todo
    语法参考:序列图语法参考


    甘特图

    todo
    语法参考:甘特图语法参考


    最后是脚注的解释内容


    -from my evernote
    (全文完)

    本文历史

    • 2019年8月6日 完成初稿。

    1. pumas are large cat-like animals which are found in America. ↩︎

    2. ruby is a script lanuage; ↩︎

    3. 这里就是脚注内容,默认会生成脚注序号 ↩︎

    文章作者: Ajioy张品茗
    文章链接: https://ajioy.cn/tools/markdown-guide/
    版权声明: 本站所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 Ajioy's World
    打赏
    • 微信
    • 支付宝

    评论