推广 热搜: 跳转  链接  查询  智能  关键词  分析  网站  下载  互联  谷歌 

Markdown 简易入门教程

   日期:2024-12-26     作者:lz1qp    caijiyuan  
核心提示:自己整理的 Markdown 简介、编辑器推荐、语法、特征等,是 Markdown 的简易入门教程概述 简介官方文档Markdown编辑器初级

自己整理的 Markdown 简介、编辑器推荐、语法、特征等,是 Markdown 的简易入门教程

  • 概述

    • 简介
    • 官方文档
    • Markdown编辑器
  • 初级语法

    • 标题
    • 粗体和斜体
    • 段落和换行
    • 分隔线
    • 引言
    • 列表
      • 无序列表
      • 有序列表
    • 代码
      • 行内代码块
      • 段落代码块
    • 链接
      • 网址链接
      • 图片链接
        • 指定图片宽高
        • 用图床获取外链
  • 进阶语法

    • 标签
    • 目录
    • 表格
    • 脚注
    • 公式
    • 流程图
    • 序列图
  • 其他

    • 兼容HTML
    • 特殊字符自动转换
    • 反斜杠
    • 自动链接
  • 感谢


简介

Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia等网站,如各大博客平台:WordPress、Drupal、简书等。

官方文档

Markdown: Syntax

Markdown 语法说明 (简体中文版)

Markdown编辑器

  • 在线编辑器

    • dillinger——漂亮强大,支持md, html, pdf 文件导出。

    • 简书——非常漂亮的博客平台,可以自动备份,直接拖入图片。

  • Windows

    • MarkdownPad——一款全功能的编辑器,被很多人称赞为windows 平台最好用的markdown编辑器。

    • MarkPad——开源软件,可以直接在你的博客或者 GitHub 中打开、保存文档,直接将图片粘贴到 Markdown 文档中。

    • Cmd Markdown——作业部落出品,全平台并支持Web端

  • Mac

    • Mou——简洁优雅,免费又好用,中文兼容性好。

    • Typora——极致简洁,自定义皮肤。

    • MacDown——简洁优雅,开源免费。

    • Ulysses——文字写作推荐。

  • 多平台

    • Atom——github出的编辑器,支持各种编程语言,可装Markdown插件。

    • sublimetext——专业编辑器,支持各种编程语言。

标题

Markdown 支持两种标题的语法,类 Atx 和类 Setext 形式。

  • Atx(注意后面有个空格

     
  • Setext(与数目任意,最好三个及以上,比较直观

     

粗体和斜体

  • 粗体

     
  • 斜体

     

段落和换行

  • 第一种写法(上图的,直接敲两个回车键即可

     
  • 第二种写法(上图的,在写完一段后敲两个空格,然后回车写下一段

     
  • 第三种写法(上图的,在写完一段后用HTML的语法:作为换行,然后写下一段

     

分隔线

可以在一行中用三个及以上的星号、减号、等于号、底线来建立分隔线,行内不能有除空格外的其他东西,注意莫被打脸。 (≖ ‿ ≖)✧

 

引言

 

列表

无序列表

无序列表可以在每行开头用星号、加号、减号来表示,也可以三者混合一起,推荐使用相同的字符,避免混乱。

 
有序列表

有序列表用数字接着一个英文句点来表示,数字可无序,但还是推荐使用、,避免混乱。

 

代码

行内代码块
 
段落代码块
 

另外,可以用三个反引号和语言名,作为标记代码所使用的语言

我的 Mou 编辑器不能识别 (ノ▼Д▼)ノ

链接

网址链接

网址链接有两种形式行内式参考式

不管是哪一种,链接文字都是用 [方括号] 来标记,双引号的可写可不写。

  • 行内式

     
  • 参考式

    • 一般写法

       
  • 隐式链接标记——可省略id,只需要[text]与下面[方括号]内容相同即可

     
  • 拓展

    • 这里的链接辨别标签可以有字母、数字、空白和标点符号,但是并不区分大小写,因此下面两个链接是一样的

       
    • 链接 title 可以用双引号、单引号、圆括号包起来,因此,下面这三种链接的定义都是相同

       

特别注意:Markdown.pl 1.0.1 会忽略单引号包起来的链接 title

图片链接

图片链接与上面的网址链接类似,同样有两种形式:行内式和参考式,只不过图片链接在前面加上一个感叹号,在此不做累述。

  • 行内式

     
  • 参考式

     
指定图片宽高
  • Markdown 一般不支持指定图片的宽高,若要指定宽高可以使用普通的 标签

     

    如果需要居中可以在外围包围标签

     
  • 使用支持指定图片大小的 Markdown 编辑器,如 Mou

     
用图床获取外链

网上有许多图床,这里推荐两个 七牛图床极简图床

    • 方法一

       
    • 方法三

       
    • 方法三

       

    目录

    • 方法一

      这种目录其实是用 HTMLMarkdown的链接 实现,分为两个部分目录部分标题部分

      • 目录部分——实质是链接,链接的填需要跳转到的标题的属性(自定义)。

         
      • 标题部分——实质是HTML的标题标签,标签里面的属性等于待跳转的目录的。

         
    • 方法二

      这种方法非常简单,就是直接添加 ,标题1~6样式的内容会被提取出来作为目录,然而有些编辑器不能使用这功能,如 Mou 不能使用。我是在有道云笔记的 Markdown 中截图的。

       

      这里有个jQuery插件,貌似可以让Markdown生成目录

      https://github.com/i5ting/i5ting_ztree_toc

    表格

    • 表格一般这样子写,这应该是最简单的写法了

       
    • 还有就是对齐了,用对齐,写在在的左边就是左对齐,右边就是右对齐,两边都写就是居中。

       

    脚注

     
    

    公式

    • 方法一:使用Google Chart

       
    • 方法二:使用forkosh

       
    • 方法三:使用codecogs

       
    • 方法四:使用MathJax引擎——先加载脚本,后解析公式。

       

    流程图

    像流程图这种复杂的功能不推荐在 Markdown 中使用,因为很多编辑器都不支持,我使用了几个编辑器都不能生成流程图,所以上图是在为知笔记官方 Markdown 新手指南中找到的。

     
    

    flowchat
    st=>start: Start
    e=>end: End
    op1=>operation: My Operation
    sub1=>subroutine: My Subroutine
    cond=>condition: Yes or No?
    io=>inputoutput: catch something…
    st->op1->cond
    cond(yes)->io->e
    cond(no)->sub1(right)->op1
    ```

    更多关于流程图的语法说明

    https://github.com/adrai/flowchart.js

    序列图

     
    

    sequenceDiagram
    Alice->>Bob: Hello Bob, how are you?
    Note right of Bob: Bob thinks
    Bob–>>Alice: I am good thanks!
    ```

    更多关于时序图的语法说明

    https://github.com/bramp/js-sequence-diagrams

    兼容HTML

    Markdown 可以和 HTML 混编,甚至可以完全用 HTML 语法来写。要注意在 HTML 标签中的 Markdown 代码是不起作用的。

     
    

    特殊字符自动转换

    • HTML 语法——在 HTML 中所有和都要转换,包括链接(URL

      • 用 表示 ——起始标签
      • 用 表示 ——标记 HTML 实体
    • Markdown 语法——Markdown 则会自动转换

    反斜杠

    Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号。如

    *literal asterisks*

    可用

     
    

    Markdown 简易入门教程

    Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号

     
    

    自动链接

    • 网址自动链接

       
    • 电子邮件自动链接

       

    Markdown: Syntax

    Markdown 语法说明 (简体中文版)

    Markdown——入门指南

    Markdown语法手册

    好用的Markdown编辑器一览

    markdown中插入图片怎么定义图片的大小或比例

    Markdown进阶语法整理

    为知笔记 Markdown 新手指南

    Markdown中插入数学公式的方法

    i5ting/i5ting_ztree_toc

    flowchart.js

    adrai/flowchart.js

    js-sequence-diagrams

本文地址:https://sicmodule.kub2b.com/tnews/5295.html     企库往 https://sicmodule.kub2b.com/ , 查看更多

特别提示:本信息由相关用户自行提供,真实性未证实,仅供参考。请谨慎采用,风险自负。

 
标签: 链接 语法
 
更多>同类生活信息

文章列表
相关文章
最新动态
推荐图文
生活信息
点击排行
网站首页  |  关于我们  |  联系方式  |  使用协议  |  版权隐私  |  网站地图  |  排名推广  |  广告服务  |  积分换礼  |  网站留言  |  RSS订阅  |  违规举报  |  鄂ICP备2020018471号