，GitHub Pages 将只支持 kramdown 作为唯一的 Markdown 引擎。...这其实也算得一件好事，之前支持 Rediscount、Redcarpet 和 kramdown 等多种引擎，而它们相互之间和与标准 Markdown 之间又有一些细微却也无法忽视的差异，这让需要在多个平台使用...Markdown 的我头疼不已，早就希望 GitHub Pages 能与 GitHub 的 Issues 和 comments 等地方统一语法，本次更新虽然做不到这一点，但也算是迈出了不小的一步。...之后的配置如下： markdown: kramdown kramdown: input: GFM highlighter: rouge 切换过程中有若干需要处理的差异问题，现将它们及解决方法记录如下...列表项里嵌套的代码块 嵌套在列表项中的代码块在 Redcarpet 中使用 Tab 进行缩进即可，而在 kramdown 中需要根据列表项的内容开始位置决定缩进的字符数。
kramdown 的列表嵌套内容的缩进规则很「奇葩」，不是使用自然的 Tab 缩进。...问题 kramdown 的作者对列表嵌套内容的缩进规则的 描述 是： kramdown does not allow 4 space indent, …… Indentation for list items...在年初 GitHub 宣布 GitHub Pages 服务将只支持 kramdown 这个 Markdown 解析引擎时，我曾经总结过从 Redcarpet 迁移到 kramdown 需要做的一些更改，...将 GitHub Pages 从 Redcarpet 切换到 kramdown 里有说到，嵌套在列表项里的代码块，如果不按如上规则做缩进的话，将会解析不正常。...当然这是最简单的一级嵌套的情况，如果是多级列表嵌套，那情况就更复杂了，每一次都去手打空格缩进吗？作为一名 Vimer，当然 say no！
kramdown 的列表嵌套内容的缩进规则很「奇葩」，不是使用自然的 Tab 缩进。...问题 kramdown 的作者对列表嵌套内容的缩进规则的 描述 是： kramdown does not allow 4 space indent, …… Indentation for list...在年初 GitHub 宣布 GitHub Pages 服务将只支持 kramdown 这个 Markdown 解析引擎时，我曾经总结过从 Redcarpet 迁移到 kramdown 需要做的一些更改，...将 GitHub Pages 从 Redcarpet 切换到 kramdown 里有说到，嵌套在列表项里的代码块，如果不按如上规则做缩进的话，将会解析不正常。...当然这是最简单的一级嵌套的情况，如果是多级列表嵌套，那情况就更复杂了，每一次都去手打空格缩进吗？作为一名 Vimer，当然 say no！
其中，markdown 字段的值表示使用哪一款插件来将 Markdown 文本转换为 HTML 页面结构。 GitHub 推荐使用的 Jekyll 的 Markdown 插件为 kramdown。...kramdown 是一个强大且高性能的文本转换引擎，你可以通过阅读 kramdown 和 markdown 较大的差异比较 - Hom 了解 kramdown 的强大之处。...: GFM 指的是 GitHub Flavored Markdown Spec。...风格的样式到 assets/css/syntax.css 文件中： $ rougify style github > assets/css/syntax.css 别忘了在你的 中把这份...以下每张图片的后面都标注了这种风格主题再 rouge 中的名称，使用上一节中提到的命令可以生成语法高亮样式。 ? ▲ github 需要额外设置前景色 #24292e ?
但是，Markdown 语法的出现无疑为博客编辑带来了一种全新的体验。按照规范化的文本内容标记编写，使用不同的 Markdown 语法翻译器和 CSS 样式，就可以带来丰富多彩的效果呈现。...之前 Github 的这个域名还是不提供 CDN 功能的，现在看起来像是有了所谓的 CDN 功能，但是实际的效果不得而知，因为笔者试着使用不同国家 IP 访问得到的地址都是美国的。...recommend-condition-size: 12 # a tag will be recommended if the size of it is more than this value # Build settings # 文章列表展示页每页显示的文章数量...', 'gulpfile.js', '.gitignore', 'README.md'] # Markdown 翻译器和语法着色工具 markdown: kramdown highlighter: prism...kramdown: input: GFM # 是否开启 RSS 订阅 RSS: true # Plugins 编译时所需的 Jekyll 插件 plugins: [jekyll-paginate
/09/16: GitHub Pages 现在已经改为只支持 kramdown），而其它放在 GitHub 仓库里的文档使用 GFM，我决定为我常用的 Markdown 编辑器 Vim 做一款同时支持...GFM 和 Redcarpet 两种 TOC 链接风格的 Table of Contents 自动生成插件。...下载地址 vim-markdown-toc 功能 为 Markdown 文件生成 Table of Contents，目前支持 GFM 和 Redcarpet 两种链接风格。...适用于 GitHub 仓库里的 Markdown 文件，比如 README.md，也适用用于生成 GitBook 的 Markdown 文件。...:GenTocRedcarpet 生成 Redcarpet 链接风格的 Table of Contents。
preface 最近又在看深度学习相关的内容，并且讲学习笔记呈现在了博客上，课程中有很多的公式，之前都是靠着截图的，但是这样就太繁琐了，想着如果能够直接敲公式的话效率就会高点了，就去看了一下 LaTeX...的语法，好像挺简单的，就稍微学习了一下，想发布到博客上发现渲染不出来 solution 博客是用 MarkDown 编写的，而 MarkDown 本身并不支持公式，但是我使用的 Typora 编辑器可以扩展...这在 Typora 里面是没有任何问题的，可以正常显示，但是 push 到基于 Jekyll 模板的 GitHub page 上就出现了不能渲染公式的问题，网上搜了一下，Jekyll 模板确实不支持...LaTeX 公式，不过有一种解决方法，那就是引入外部的 js脚本，可能会影响一点加载速度，但是我也没有什么明显的感觉(可能因为我挂着全局代理) 具体方法就是，到 _config.yml 中加上一行 markdown...: kramdown ，再打开 _includes 文件夹中的 head.html ，将下面这段脚本粘贴进去，提交修改，就可以正常渲染 LaTeX 公式了 <script type="text/x-mathjax-config
本文记录使用Mou和Stackedit中出现的一些问题，使其能够正常渲染带数学公式的文章 如果Mou渲染Math公式有问题的话，尝试在第一行加上如下js，表示让Mou去加载Mathjax的脚本 <!...，使用kramdown代替默认的rdiscount，然后在footer.html中加入上面的脚本内容。...过去的内容，也许不对… [但是，它还是存在些问题，关于inline Math公式的问题，推荐将Octopress中的Markdown引擎换成Kramdown，参考教程，另外，使用inline Math...Stackedit支持直接将文档publish到Github的某个项目的某个分支下的某个文件夹中，文件名自己命名。如下图所示： ?...我使用的方法是Import from URL功能，其中的URL是该Markdown文档的URL，可以在Github中找到并打开那个文档，点击Raw按钮就会进入这份文档的源代码页面，复制该页面的URL即可
Emacs的Org-mode是强大的，但没有很好的客户端工具，用来在不同的设备上同步我们的笔记。不过我们也可以把Emacs的笔记直接放到GitHub上，GitHub也是支持.org格式的文档的。...接下来说说云笔记的好处有哪些。它的好处不用多说，我认为最大的好处是：一处书写，到处可见。这是很屌的。...简单 列表连数字都自动排好 无序列表 无序列表 嵌套列表 自动缩进 上述的MarkDown格式为： #### 这是四级标题 一般写文章或论文，三级标题就够用了。不是吗？...列表连数字都自动排好 * 无序列表 * 无序列表 * 嵌套列表 * 自动缩进 代码一览 如果要插入一段代码块，可以把代码放到一对"`"中即可。...在MarkDown中，要想强调文字，如果要想把强调的文字以斜体的形式呈现，只需要把要强调的文字放到一对*或一对_之间即可。
它有一个模版目录，其中包含原始文本格式的文档，通过一个转换器（如 Markdown）和我们的 Liquid 渲染器转化成一个完整的可发布的静态网站，你可以发布在任何你喜爱的服务器上。...创建一个 Github 库并开启 Github Pages 首先我们用自己的 Github 账号创建一个新的库（repository），这个库的名称有固定的格式： username.github.io，..._config.yml里相关的参数如下： markdown: kramdown highlighter: rouge kramdown: input: GFM 根据上面的教程，我们已经配置好 Ruby...在本地博客文件的根目录里打开命令行，使用命令rougify style github > css/syntax.css生成一个 github 风格的样式到css/syntax.css文件中。...这里有你想要的 Rouge 主题 ----
支持html和css （三）GitHub 风格的表格 使用示例： | Tables | Are | Cool | | ------------- |:--------...GitHub 风格的表格示例 （四）Emoji 使用示例： :tada: :100::fire: 使用效果如下图所示： ?...Matter设置： 选项 写法示例 作用 navbar navbar: false false表示：禁用页面的导航栏 sidebarDepth sidebarDepth: 2 设置侧边栏的嵌套的标题链接最大深度...nav下拉列表 你还可以通过嵌套的 items 来在 下拉列表 中设置分组，如下所示： module.exports = { themeConfig: { nav: [ {...侧边栏标题优先级 可以通过上文提到的 YAML front matter 来设置侧边栏的嵌套的标题链接最大深度。
图4 基于Ol()与Li()渲染有序列表 利用Ol()嵌套多个Li()，可以自动渲染出带序号的有序列表，就像下面这个简单的例子： app4.py import dash import dash_html_components...图5 基于Ul()与Li()渲染层级列表 而除了与Ol()相互配合之外，Li()还可以嵌套在Ul()中渲染带层级关系的列表： app5.py import dash import dash_html_components...图10 2.2 dcc.Markdown()——Dash中特殊的静态部件 在Dash中还存在一个比较特别的用于呈现静态内容的部件——dcc.Markdown()，它的children参数接受markdown...代码，并自动在网页中呈现出渲染后的效果，其主要参数如下： children：字符型markdown源码 dangerously_allow_html：bool型，用于设置是否允许解析出markdown...图11 有了Markdown()部件的加持，我们就可以在某些情况下直接利用markdown快速编写网页，譬如编写在线文档说明页面~ 3 利用Dash自制在线Markdown编辑器 在掌握了今天的教程所涉及知识之后
Blockquote()实现块引用」 利用dash_html_components中的Blockquote()，我们可以直接传入字符串，或嵌套其他元素，从而构造出块引用，就像markdown中的>所包含渲染的内容那样...」 利用Ol()嵌套多个Li()，可以自动渲染出带序号的有序列表，就像下面这个简单的例子： ❝app4.py ❞ import dash import dash_html_components as html...」 而除了与Ol()相互配合之外，Li()还可以嵌套在Ul()中渲染带层级关系的列表： ❝app5.py ❞ import dash import dash_html_components as html...()——Dash中特殊的静态部件 在Dash中还存在一个比较特别的用于呈现静态内容的部件——dcc.Markdown()，它的children参数接受markdown代码，并自动在网页中呈现出渲染后的效果...，其主要参数如下： ❝「children」：字符型markdown源码 「dangerously_allow_html」：bool型，用于设置是否允许解析出markdown源码中的html代码并渲染，默认为
当前许多网站都支持用 Markdown 来撰写文档 如 博客园、CSDN、简书、语雀 等，有了这么多网站的支持，你可以随时随地上传本地 MarkDown 文件到博客中 MarkDown 基本语法 一、...[alt](图片地址 ''title'') alt 指的是当图片链接失效时显示的提示文字，可加可不加 title是图片的标题，当鼠标移到图片上时显示的内容，可加可不加 如果你想要调整图片大小，有两种方式...硬换行：你可以通过 空格+ 空格+ shift+enter完成一次硬换行，而这也是许多 Markdown 编辑器所原生支持的。硬换行在文档被导出时将被保留，且没有换段的段后距。...Windows 风格（CR+LF）与 Unix 风格（LF）的换行符：CR表示回车\r，即回到一行的开头，而LF表示换行\n，即另起一行。...所以 Windows 风格的换行符本质是「回车+换行」，而 Unix 风格的换行符是「换行」。这也是为什么 Unix/Mac 系统下的文件，如果在 Windows 系统直接打开会全部在同一行内。
github pages 一直想添加代码高亮 highlighter ，基于 jekyll 3.0 的 rouge 终于搞定了： ?...下载代码高亮库 在 cmd 中输入： rougify style monokai.sublime > rouge.css 可以下载 rouge.css 出来，将这个 css 文件放到 github pages..._config.yml 中添加这些： markdown: kramdown kramdown: syntax_highlighter: rouge 将博文 md 文件中的 ``` 替换为 ~~~ruby...SourceElement().parentNode.className+=' has-jax';}}); 在 cmd 中输入 jekyll server，本地打开 127.0.0.1:4000 查看代码是否高亮了...，可以在我的 github pages 代码中查看具体的详情
gem install pygments.rb 然后是修改 _config.yml 配置文件，其中的 highlighter 修改如下： markdown: kramdown highlighter...另外，Rouge 的主题和 Pygments 是完全兼容的，所以如果是从 Pygments 变到 Rouge，只需要在 _config.yml 配置文件做如下修改即可： markdown: kramdown...由于 Markdown 语言解析器对 Markdown 标准支持的不同，可能不支持 LaTex 公式，本站所使用的主题原来就尚未对 Markdown 公式或者 LaTex 公式进行支持。...毕竟中英文字符还是有差别的嘛。这个问题在参考资料的博文中做了一些比较深刻的讨论，最后给出来的方案就是这里采用的方案。...这个问题其实主要还是在统计上，由于这些非可计数内容不在正常字数统计内，也无法根据它们的数量来评估对应所需的时间，自然也不能加入到阅读时长里。
GFM 即 GitHub Flavored Markdown，是 GitHub 用在 Respository、Issues、Comments 和 Pull requests 里的一种 Markdown...在这里做个小广告：如果你使用 Vim 编辑 Markdown，那可以试试我写的能自动生成 GFM 和 Redcarpet 这两种风格 TOC 的 Vim 插件 vim-markdown-toc。...和空格替换为 -，有两个及以上 - 的地方修复成一个，将链接串首尾的 -_ 删除。 列表下嵌套内容 在 Redcarpet 中有如下规则： 如果嵌套非列表，需要缩进并且空行。...如果嵌套列表，需要缩进，但不空行。 而 GFM 则没有。...Task Lists 这货真是个好东西，用 - [ ] 和 - [ x ] 就能做出清单列表项的显示效果来，而且如果你有编辑权限的话点选后文本能自动更新。 ?
GitHub Pages 更新 由 Ghostzhang 发表于 2016-05-07 02:26 有段时间没有更新了，没想到一更新就收到GitHub的邮件，说是系统升级了，因为使用了一些旧的功能，...首先，看看这次系统升级了些什么，根据邮件指示，来到了这里：GitHub Pages now faster and simpler with Jekyll 3.0，大概的意思是GitHub Pages更新到...Jekyll 3.0了，有以下几点变动： 2016年5月1号开始，GitHub Pages只支持kramdown,作为Jekyll的默认Markdown引擎，如果你用的是其它的引擎，那么你有三个月时间进行更新...原先如果使用{% highlight js %} code {% endhighlight %} 的方式进行代码高亮，那么就得修改啦，用```即可，详见 https://help.github.com...Jekyll 3.0对本地版本的优化，我没有使用过，不太了解，有兴趣的同学自己到上面的链接看吧。
领取专属 10元无门槛券
手把手带您无忧上云
