其他一些markdown语法的总结
2017.9.15 五 12:24
A Markdown 编辑器语法指南
https://segmentfault.com/markdown
基本技巧
代码
如果你只想高亮语句中的某个函数名或关键字,可以使用 function_name()
实现
通常编辑器根据代码片段适配合适的高亮方法,但你也可以用 1
2
3
4
5
```javascript
$(document).ready(function () {
alert('hello world');
});
支持的语言:1c, abnf, accesslog, actionscript, ada, apache, applescript, arduino, armasm, asciidoc, aspectj, autohotkey, autoit, avrasm, awk, axapta, bash, basic, bnf, brainfuck, cal, capnproto, ceylon, clean, clojure, clojure-repl, cmake, coffeescript, coq, cos, cpp, crmsh, crystal, cs, csp, css, d, dart, delphi, diff, django, dns, dockerfile, dos, dsconfig, dts, dust, ebnf, elixir, elm, erb, erlang, erlang-repl, excel, fix, flix, fortran, fsharp, gams, gauss, gcode, gherkin, glsl, go, golo, gradle, groovy, haml, handlebars, haskell, haxe, hsp, htmlbars, http, hy, inform7, ini, irpf90, java, javascript, json, julia, kotlin, lasso, ldif, leaf, less, lisp, livecodeserver, livescript, llvm, lsl, lua, makefile, markdown, mathematica, matlab, maxima, mel, mercury, mipsasm, mizar, mojolicious, monkey, moonscript, n1ql, nginx, nimrod, nix, nsis, objectivec, ocaml, openscad, oxygene, parser3, perl, pf, php, pony, powershell, processing, profile, prolog, protobuf, puppet, purebasic, python, q, qml, r, rib, roboconf, rsl, ruby, ruleslanguage, rust, scala, scheme, scilab, scss, smali, smalltalk, sml, sqf, sql, stan, stata, step21, stylus, subunit, swift, taggerscript, tap, tcl, tex, thrift, tp, twig, typescript, vala, vbnet, vbscript, vbscript-html, verilog, vhdl, vim, x86asm, xl, xml, xquery, yaml, zephir
也可以使用 4 空格缩进,再贴上代码,实现相同的的效果
def g(x):
yield from range(x, 0, -1)
yield from range(x)
如你不需要代码高亮,可以用下面的方法禁用:
1 | $(document).ready(function () { |
分隔符
如果你有写分割线的习惯,可以新起一行输入三个减号-。当前后都有段落时,请空出一行:(因为-还有另一作用:二级标题)
前面的段落
后面的段落
高级技巧
行内 HTML 元素
目前只支持部分段内 HTML 元素效果,包括<kdb> <b> <i> <em> <sup> <sub> <br>
,如
键位显示:使用 Ctrl+Alt+Del 重启电脑
代码块:使用
元素同样可以形成代码块粗斜体 Markdown 在此处同样适用,如 加粗
符号转义:如果你的描述中需要用到 markdown 的符号,比如 _ # 等,但又不想它被转义,这时候可以在这些符号前加反斜杠,如 _ # \ 进行避免。
扩展
支持 jsfiddle、gist、runjs、优酷视频,直接填写 url,在其之后会自动添加预览点击会展开相关内容。
http://{url_of_the_fiddle}/embedded/[{tabs}/[{style}]]/
https://gist.github.com/{gist_id}
http://runjs.cn/detail/{id}
http://v.youku.com/v_show/id_{video_id}.html
公式
当你需要在编辑器中插入数学公式时,可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。如:
$$ x = {-b \pm \sqrt{b^2-4ac} \over 2a}. $$
$$
x \href{why-equal.html}{=} y^2 + 1
$$
同时也支持 HTML 属性,如:
$$ (x+1)^2 = \class{hidden}{(x+1)(x+1)} $$
$$
(x+1)^2 = \cssId{step1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$
游乐场
(这篇文章最下面,放了一个编辑器,,公式都可以输出)
1 | 总结: |
B Markdown语法介绍
https://coding.net/help/doc/project/markdown.html
锚点
Coding 会针对每个标题,在解析时都会添加锚点id,如
# C 锚点
问内链接;
列表
代办列表: 表示列表是否勾选状态
- 不勾选
- 勾选
1 | github的编辑器可以,上面的游乐场不行;流程图,扩展两个地方都没有显示 |
表格
在 Markdown 中,可以制作表格,例如:1
2
3
4First Header | Second Header | Third Header
------------ | ------------- | ------------
Content Cell | Content Cell | Content Cell
Content Cell | Content Cell | Content Cell
1 | 隐约好像在代码块中出现过表格,发生错觉了??有可能看错了 |
First Header | Second Header | Third Header
------------ | ------------- | ------------
Content Cell | Content Cell | Content Cell
Content Cell | Content Cell | Content Cell
上下标
\^表示上标, _表示下标。如果上下标的内容多于一个字符,要用{}把这些内容括起来当成一个整体。上下标是可以嵌套的,也可以同时使用。 例如:
x^{y^z}=(1+{\rm e}^x)^{-2xy^w}
2017.9.15 五 13:10
段落缩进2017.9.15 五 14:32
C Mastering Markdown
https://guides.github.com/features/mastering-markdown/#GitHub-flavored-markdown
What is Markdown?
Examples
Text Lists Images Headers&Quotes Code Extras
Syntax guide
….
GitHub Flavored Markdown
1 Syntax highlighting
2 Task Lists
- @mentions, #refs, links, formatting, and
tagssupported - list syntax required (any unordered or ordered list supported)
- this is a complete item
- this is an incomplete item
3 Tables
4 SHA references
Any reference to a commit’s SHA-1 hash will be automatically converted into a link to that commit on GitHub.
16c999e8c71134401a78d4d46435517b2271d6ac
mojombo@16c999e8c71134401a78d4d46435517b2271d6ac
mojombo/github-flavored-markdown@16c999e8c71134401a78d4d46435517b2271d6ac
5 Issue references within a repository
Any number that refers to an Issue or Pull Request will be automatically converted into a link.
#1
mojombo#1
mojombo/github-flavored-markdown#1
6 Username @mentions
7 Automatic linking for URLs
Any URL (like http://www.github.com/) will be automatically converted into a clickable link.
8 Strikethrough
Any word wrapped with two tildes (like this) will appear crossed out. 说白了,还是删除线
9 Emoji
@octocat :+1: This PR looks great - it’s ready to merge! :shipit:
2017.9.15 五 15:00