时间:2021-07-01 10:21:17 帮助过:91人阅读
在刚才的导语里提到,Markdown 是一种用来写作的轻量级「标记语言」,它用简洁的语法代替排版,而不像一般我们用的字处理软件 Word 或 Pages 有大量的排版、字体设置。它使我们专心于码字,用「标记」语法,来代替常见的排版格式。例如此文从内容到格式,甚至插图,键盘就可以通通搞定了。目前来看,支持 Markdown 语法的编辑器有很多,包括很多网站(例如简书)也支持了 Markdown 的文字录入。Markdown 从写作到完成,导出格式随心所欲,你可以导出 HTML 格式的文件用来网站发布,也可以十分方便的导出 PDF 格式,这种格式写出的简历更能得到 HR 的好感。甚至可以利用 CloudApp 这种云服务工具直接上传至网页用来分享你的文章,全球最大的轻博客平台 Tumblr,也支持使用 Mou 这类 Markdown 工具进行编辑并直接上传。
python的markdown扩展开发
近期使用python的markdown写了一个文档小程序,由于需要用到一些额外的功能,所以就对markdown进行了一些简单的扩展,进而记录下编写的模板。直接贴代码:
- #encoding=utf-8
- ##预处理器
- from markdown.preprocessors import Preprocessor
- class CodePreprocessor(Preprocessor):
- def run(self, lines):
- new_lines = []
- flag_in = False
- block = []
- for line in lines:
- if line[:3]=='!!!':
- flag_in = True
- block.append('<pre class="brush: %s; layui-box layui-code-view layui-code-notepad"><ol class="layui-code-ol"><li>' % line[3:].strip()) </li><li> elif flag_in: </li><li> if line.strip() and line[0]=='!': </li><li> block.append(line[1:]) </li><li> else: </li><li> flag_in = False </li><li> block.append('</li></ol></pre>')
- block.append(line)
- new_lines.extend(block)
- block = []
- else:
- new_lines.append(line)
- if not new_lines and block:
- new_lines = block
- return new_lines
- ##后置处理器
- from markdown.postprocessors import Postprocessor
- class CodePostprocessor(Postprocessor):
- def run(self, text):
- t_list = []
- for line in text.split('\n'):
- if line[:5]=='<p>!<':
- line = line.lstrip('</p><p>').replace('</p>', '')[1:]
- t_list.append(line)
- return '\n'.join(t_list)
- ##扩展主体类
- from markdown.extensions import Extension
- from markdown.util import etree
- class CodeExtension(Extension):
- def __init__(self, configs={}):
- self.config = configs
- def extendMarkdown(self, md, md_globals):
- ##注册扩展,用于markdown.reset时扩展同时reset
- md.registerExtension(self)
- ##设置Preprocessor
- codepreprocessor = CodePreprocessor()
- #print md.preprocessors.keys()
- md.preprocessors.add('codepreprocessor', codepreprocessor, '<normalize_whitespace') ##设置postprocessor="" codepostprocessor="CodePostprocessor()" #print="" md.postprocessors.keys()="" md.postprocessors.add('codepostprocessor',="" codepostprocessor,="" '="">unescape')
- ##print md_globals ##markdown全局变量
- </normalize_whitespace')>
关于markdown扩展的深入内容,可以查看官方文档,不过没有例子,只是手册而已。但大体能知道有哪些内容组成,在结合上面的文件结构都是可以写出来的。下面是调用的代码:
- #encoding=utf-8
- import markdown
- import markdowncode
- text = '''''
- !!!python
- !
- !def foo():
- ###title
- '''
- configs = {}
- myext = markdowncode.CodeExtension(configs=configs)
- md = markdown.markdown(text, extensions=[myext])
- print md
主要扩展了2个功能:
一个是把形如:
- !!!python
- !
- !def foo():
- ! return 'foo'
转换成:
- <pre class="brush: python; layui-box layui-code-view layui-code-notepad"><ol class="layui-code-ol"><li> </li><li> </li><li>def foo(): </li><li> return 'foo' </li><li></li></ol></pre>