百度360必应搜狗淘宝本站头条
当前位置:网站首页 > IT知识 > 正文

「Python」办公自动化——用类Markdown的语法来写Word文档

liuian 2024-12-01 00:56 33 浏览

前言

本篇文章是笔者在学习了python-docx库后就一直想写的一篇,但是因为时间关系一直没机会动笔,最近正好不忙就和大家一起分享一下。本篇可以看成是办公自动化Word系列的最后一篇,python-docx库官方使用文档的后续翻译以后应该也不会有了。

办公自动化这个系列后续还会有Excel篇,应该也会分为官方使用文档的说明和一到两篇使用实例。其实就使用频率来说Excel的自动化是笔者使用最多也最有价值的,但就是因为使用太过频繁、应用场景太过广泛,所以笔者一时也不知如何动笔,不知道怎样才能将其讲好。不过身为一个强迫症,在PPT实战篇也完成后,笔者就会开始慢慢更新Excel系列,有需要的读者可以期待一下。

项目介绍

笔者因为公司电脑会对Office文档自动加密的缘故,平常较少使用Word进行文字记录,基本所有的个人笔记内容都是通过Markdown来进行记录的,在此也向读者安利一个Markdown文本编辑器Typora,用过之后笔者相信大部分人都不会再想用Word来记录非正式的笔记内容了。习惯了编辑器自动排版,笔者现在是完全不想浪费时间在Word排版上,虽然通过应用模板的方式Word自身也能实现部分自动排版功能,但是并不能仅通过键入字符的方式简单完成,不够优雅。

Markdown虽好,但在正式场合还是有局限性的,自己个人使用当然是千般好,不过给别人看的时候就只能笑笑了。网上其实有现成的软件可以将md格式的文件转为docx格式,但是笔者个人认为功能还是不够完善,排版的自定义程度并不是很够用。

既然没有现成满意的那就只好自己动手了,万幸大部分轮子都有大佬搭好了,而笔者只需要做个装配工就成了,拼辆车还是很简单的。

功能目标

采用Markdown的语法结构为基础,进行部分简化和拓展,最终实现在txt文本编辑器中键入纯文本后运行脚本即可得到指定样式的Word文档。

因为Markdown原本的语法全部实现较为费时,并且笔者本来的目的也不是实现md和docx的互转,仅仅只是想要通过纯文本的方式实现Word文档的优雅编写,所以在此对Markdown语法进行部分保留和拓展:

  • #:此为Markdown中的标题语法,笔者在此进行保留,但是只支持到四级标题。
  • -:此为Markdown中的无须项目符号语法,笔者在此保留并进行拓展,和标题类似,可以键入多个减号来实现多级项目符号,最多三级。
  • **:此为Markdown中的粗体语法,笔者在此保留并简化,规定此语法只能在正文段落中使用。
  • $:此为Markdown中的Latex公式语法,笔者在此保留,为了便于添加到Word中,此处将公式转化为图片。
  • !:此为Markdown中的图片语法的简化写法
  • 其他Markdown语法全部舍弃,例如引用、表格、代码块等,其中表格功能后续可能会添加进去。

笔者保留的语法都是完成一篇Word文档必不可少的部分,当然表格由于实现起来成本较高被舍去了。项目目标到此已经相当明确,下面笔者将为读者讲解具体的实现过程。

完成思路

首先简化Word文档,我们将Word文档看成是由若干段落组成的纯文本,同时规定上述所有的语法符号除**外都只能出现在段落开头。接下来思路就很清晰了,每一段作为一个最小单元,通过段落开头的语法符号分别调用不同的函数进行格式排版即可。这样我们只需要构建一个类,在类中为每一个语法符号编写一个方法就可以了。

源码展示

代码的讲解通过注释的形式来完成,读者如果有不明白的地方可以评论或者私信笔者,当然,常识性的问题不予解答,下面是代码部分:

import os, sys
import numpy as np
import matplotlib.pyplot as plt
from PIL import Image, ImageOps
from docx import Document
from docx.shared import Pt, Cm
from docx.shared import RGBColor
from docx.enum.style import WD_STYLE_TYPE
from docx.enum.text import WD_LINE_SPACING
from docx.enum.text import WD_ALIGN_PARAGRAPH


class Word(object):#定义类
    def __init__(self):#创建类实例时自动执行的初始化方法
        self.__document = Document()#此处变量前__符号表示该变量仅支持类内部调用,外部无法修改该变量
        self.__filename = '炜智能.docx'
        styles = self.__document.styles
        
        #定义段落样式:一级标题,用于文章标题
        style = styles.add_style('h1', WD_STYLE_TYPE.PARAGRAPH)
        style.base_style = styles['Normal']
        paragraph_format = style.paragraph_format
        font = style.font
        size = 22#二号
        #字号和磅对应关系如下:42磅对应初号、copy36磅对应小初、26磅对应一号、24磅对应小一号、22磅对应二号、18磅对应zd小二号、16磅对应三号、15磅对应小三号、14磅对应四号、12磅对应小四号、10.5磅对应五号、9磅对应小五号、7.5磅对应六号、6.5磅对应小六号、5.5磅对应七号、5磅对应八号。
        paragraph_format.alignment = WD_ALIGN_PARAGRAPH.CENTER#设置段落居中对齐
        paragraph_format.line_spacing_rule = WD_LINE_SPACING.ONE_POINT_FIVE#设置一点五倍行距
        paragraph_format.space_before = Pt(size / 2)#设置段前段后为0.5倍行距
        paragraph_format.space_after = Pt(size / 2)
        paragraph_format.left_indent = 0#左缩进
        font.name = '黑体'#设置字体名称
        font.size = Pt(size)#设置字体大小
        font.color.rgb = RGBColor(0, 0, 0)#设置字体颜色为黑
        font.bold = True#是否粗体
        font.italic = False#是否斜体
        style.hidden = False#是否隐藏
        style.quick_style = True#是否显示
        style.priority = 1#样式排序
        
        #定义段落样式:二级标题
        style = styles.add_style('h2', WD_STYLE_TYPE.PARAGRAPH)
        style.base_style = styles['Heading 1']
        paragraph_format = style.paragraph_format
        font = style.font
        size = 16#三号
        paragraph_format.alignment = WD_ALIGN_PARAGRAPH.LEFT#设置段落居左对齐
        paragraph_format.line_spacing_rule = WD_LINE_SPACING.ONE_POINT_FIVE#设置一点五倍行距
        paragraph_format.space_before = Pt(size / 2)#设置段前段后为0.5倍行距
        paragraph_format.space_after = Pt(size / 2)
        paragraph_format.left_indent = 0#左缩进
        font.name = '黑体'#设置字体名称
        font.size = Pt(size)#设置字体大小
        font.color.rgb = RGBColor(0, 0, 0)#设置字体颜色为黑
        font.bold = True#是否粗体
        font.italic = False#是否斜体
        style.hidden = False#是否隐藏
        style.quick_style = True#是否显示
        style.priority = 2#样式排序
        
        #定义段落样式:三级标题
        style = styles.add_style('h3', WD_STYLE_TYPE.PARAGRAPH)
        style.base_style = styles['Heading 2']
        paragraph_format = style.paragraph_format
        font = style.font
        size = 14#四号
        paragraph_format.alignment = WD_ALIGN_PARAGRAPH.LEFT#设置段落居左对齐
        paragraph_format.line_spacing_rule = WD_LINE_SPACING.ONE_POINT_FIVE#设置一点五倍行距
        paragraph_format.space_before = Pt(size / 2)#设置段前段后为0.5倍行距
        paragraph_format.space_after = Pt(size / 2)
        paragraph_format.left_indent = Pt(24)#左缩进
        font.name = '黑体'#设置字体名称
        font.size = Pt(size)#设置字体大小
        font.color.rgb = RGBColor(0, 0, 0)#设置字体颜色为黑
        font.bold = True#是否粗体
        font.italic = False#是否斜体
        style.hidden = False#是否隐藏
        style.quick_style = True#是否显示
        style.priority = 3#样式排序
        
        #定义段落样式:四级标题
        style = styles.add_style('h4', WD_STYLE_TYPE.PARAGRAPH)
        style.base_style = styles['Heading 3']
        paragraph_format = style.paragraph_format
        font = style.font
        size = 12#小四号
        paragraph_format.alignment = WD_ALIGN_PARAGRAPH.LEFT#设置段落居左对齐
        paragraph_format.line_spacing_rule = WD_LINE_SPACING.ONE_POINT_FIVE#设置一点五倍行距
        paragraph_format.space_before = Pt(size / 2)#设置段前段后为0.5倍行距
        paragraph_format.space_after = Pt(size / 2)
        paragraph_format.left_indent = Pt(24)#左缩进
        font.name = '黑体'#设置字体名称
        font.size = Pt(size)#设置字体大小
        font.color.rgb = RGBColor(0, 0, 0)#设置字体颜色为黑
        font.bold = True#是否粗体
        font.italic = False#是否斜体
        style.hidden = False#是否隐藏
        style.quick_style = True#是否显示
        style.priority = 4#样式排序
        
        #定义段落样式:二级标题
        style = styles.add_style('h2', WD_STYLE_TYPE.PARAGRAPH)
        style.base_style = styles['Heading 1']
        paragraph_format = style.paragraph_format
        font = style.font
        size = 16#三号
        paragraph_format.alignment = WD_ALIGN_PARAGRAPH.LEFT#设置段落居左对齐
        paragraph_format.line_spacing_rule = WD_LINE_SPACING.ONE_POINT_FIVE#设置一点五倍行距
        paragraph_format.space_before = Pt(size / 2)#设置段前段后为0.5倍行距
        paragraph_format.space_after = Pt(size / 2)
        paragraph_format.left_indent = 0#左缩进
        font.name = '黑体'#设置字体名称
        font.size = Pt(size)#设置字体大小
        font.color.rgb = RGBColor(0, 0, 0)#设置字体颜色为黑
        font.bold = True#是否粗体
        font.italic = False#是否斜体
        style.hidden = False#是否隐藏
        style.quick_style = True#是否显示
        style.priority = 2#样式排序
        
        #定义段落样式:三级标题
        style = styles.add_style('h3', WD_STYLE_TYPE.PARAGRAPH)
        style.base_style = styles['Heading 2']
        paragraph_format = style.paragraph_format
        font = style.font
        size = 14#四号
        paragraph_format.alignment = WD_ALIGN_PARAGRAPH.LEFT#设置段落居左对齐
        paragraph_format.line_spacing_rule = WD_LINE_SPACING.ONE_POINT_FIVE#设置一点五倍行距
        paragraph_format.space_before = Pt(size / 2)#设置段前段后为0.5倍行距
        paragraph_format.space_after = Pt(size / 2)
        paragraph_format.left_indent = Pt(24)#左缩进
        font.name = '黑体'#设置字体名称
        font.size = Pt(size)#设置字体大小
        font.color.rgb = RGBColor(0, 0, 0)#设置字体颜色为黑
        font.bold = True#是否粗体
        font.italic = False#是否斜体
        style.hidden = False#是否隐藏
        style.quick_style = True#是否显示
        style.priority = 3#样式排序
        
        #定义段落样式:四级标题
        style = styles.add_style('h4', WD_STYLE_TYPE.PARAGRAPH)
        style.base_style = styles['Heading 3']
        paragraph_format = style.paragraph_format
        font = style.font
        size = 12#小四号
        paragraph_format.alignment = WD_ALIGN_PARAGRAPH.LEFT#设置段落居左对齐
        paragraph_format.line_spacing_rule = WD_LINE_SPACING.ONE_POINT_FIVE#设置一点五倍行距
        paragraph_format.space_before = Pt(size / 2)#设置段前段后为0.5倍行距
        paragraph_format.space_after = Pt(size / 2)
        paragraph_format.left_indent = Pt(24)#左缩进
        font.name = '黑体'#设置字体名称
        font.size = Pt(size)#设置字体大小
        font.color.rgb = RGBColor(0, 0, 0)#设置字体颜色为黑
        font.bold = True#是否粗体
        font.italic = False#是否斜体
        style.hidden = False#是否隐藏
        style.quick_style = True#是否显示
        style.priority = 4#样式排序
        
        #定义段落样式:五级标题,用于图片、表格等的说明文字
        style = styles.add_style('h5', WD_STYLE_TYPE.PARAGRAPH)
        style.base_style = styles['Normal']
        paragraph_format = style.paragraph_format
        font = style.font
        size = 10.5#五号
        paragraph_format.alignment = WD_ALIGN_PARAGRAPH.CENTER#设置段落居中对齐
        paragraph_format.line_spacing_rule = WD_LINE_SPACING.ONE_POINT_FIVE#设置一点五倍行距
        paragraph_format.space_before = Pt(size / 2)#设置段前段后为0.5倍行距
        paragraph_format.space_after = Pt(size / 2)
        paragraph_format.left_indent = 0#左缩进
        font.name = '黑体'#设置字体名称
        font.size = Pt(size)#设置字体大小
        font.color.rgb = RGBColor(0, 0, 0)#设置字体颜色为黑
        font.bold = False#是否粗体
        font.italic = False#是否斜体
        style.hidden = False#是否隐藏
        style.quick_style = True#是否显示
        style.priority = 5#样式排序
        
        #定义段落样式:正文样式
        style = styles.add_style('body', WD_STYLE_TYPE.PARAGRAPH)
        style.base_style = styles['Body Text']
        paragraph_format = style.paragraph_format
        font = style.font
        size = 12#小四号
        paragraph_format.alignment = WD_ALIGN_PARAGRAPH.LEFT#设置段落居左对齐
        paragraph_format.line_spacing_rule = WD_LINE_SPACING.ONE_POINT_FIVE#设置一点五倍行距
        paragraph_format.space_before = 0#设置段前为0倍行距
        paragraph_format.space_after = Pt(size / 2)
        paragraph_format.first_line_indent = Pt(size * 2)#首行缩进
        font.name = '宋体'#设置字体名称
        font.size = Pt(size)#设置字体大小
        font.color.rgb = RGBColor(0, 0, 0)#设置字体颜色为黑
        font.bold = False#是否粗体
        font.italic = False#是否斜体
        style.hidden = False#是否隐藏
        style.quick_style = True#是否显示
        style.priority = 6#样式排序
        
        #定义段落样式:一级无序项目符号
        style = styles.add_style('l1', WD_STYLE_TYPE.PARAGRAPH)
        style.base_style = styles['List Bullet']
        paragraph_format = style.paragraph_format
        font = style.font
        size = 12#小四号
        paragraph_format.alignment = WD_ALIGN_PARAGRAPH.LEFT#设置段落居左对齐
        paragraph_format.line_spacing_rule = WD_LINE_SPACING.ONE_POINT_FIVE#设置一点五倍行距
        paragraph_format.space_before = 0#设置段前段后为0倍行距
        paragraph_format.space_after = 0
        font.name = '宋体'#设置字体名称
        font.size = Pt(size)#设置字体大小
        font.color.rgb = RGBColor(0, 0, 0)#设置字体颜色为黑
        font.bold = False#是否粗体
        font.italic = False#是否斜体
        style.hidden = False#是否隐藏
        style.quick_style = True#是否显示
        style.priority = 7#样式排序
        
        #定义段落样式:二级无序项目符号
        style = styles.add_style('l2', WD_STYLE_TYPE.PARAGRAPH)
        style.base_style = styles['List Bullet 2']
        paragraph_format = style.paragraph_format
        font = style.font
        size = 12#小四号
        paragraph_format.alignment = WD_ALIGN_PARAGRAPH.LEFT#设置段落居左对齐
        paragraph_format.line_spacing_rule = WD_LINE_SPACING.ONE_POINT_FIVE#设置一点五倍行距
        paragraph_format.space_before = 0#设置段前段后为0倍行距
        paragraph_format.space_after = 0
        font.name = '宋体'#设置字体名称
         font.size = Pt(size)#设置字体大小
        font.color.rgb = RGBColor(0, 0, 0)#设置字体颜色为黑
        font.bold = False#是否粗体
        font.italic = False#是否斜体
        style.hidden = False#是否隐藏
        style.quick_style = True#是否显示
        style.priority = 8#样式排序
        
        #定义段落样式:三级无序项目符号
        style = styles.add_style('l3', WD_STYLE_TYPE.PARAGRAPH)
        style.base_style = styles['List Bullet 3']
        paragraph_format = style.paragraph_format
        font = style.font
        size = 12#小四号
        paragraph_format.alignment = WD_ALIGN_PARAGRAPH.LEFT#设置段落居左对齐
        paragraph_format.line_spacing_rule = WD_LINE_SPACING.ONE_POINT_FIVE#设置一点五倍行距
        paragraph_format.space_before = 0#设置段前段后为0倍行距
        paragraph_format.space_after = 0
        font.name = '宋体'#设置字体名称
        font.size = Pt(size)#设置字体大小
        font.color.rgb = RGBColor(0, 0, 0)#设置字体颜色为黑
        font.bold = False#是否粗体
        font.italic = False#是否斜体
        style.hidden = False#是否隐藏
        style.quick_style = True#是否显示
        style.priority = 9#样式排序

    def save(self, filename = None):#保存文件
        if filename == None:
            filename = self.__filename
        self.__document.save(filename)

    def add_heading(self, text, level):#添加标题段落,输入为标题文本和标题级别
        if level in [1, 2, 3, 4, 5]:
            paragraph = self.__document.add_paragraph(style = 'h' + str(level))#添加段落,选择对应级别的段落样式
            run = paragraph.add_run(text)#在段落中添加文本
            if level == 1:#如果是正文标题的话就更改内置变量__filename的值,方便后面保存文件时命名
                self.__filename = text + '.docx'
        else:
            raise SyntaxError(u'标题等级为1-5')

    def add_body(self, text):#添加正文段落
        paragraph = self.__document.add_paragraph(style = 'body')#添加段落
        texts = text.split('**')#以**来对文本分段
        for x in range(len(texts)):
            if x % 2 != 0:#索引值为奇数
                paragraph.add_run(texts[x]).font.bold = True#**之间的文本加粗
            else:
                paragraph.add_run(texts[x])#在段落中添加文本

    def add_list(self, text, level):#添加无序列表符号段落
        if level in [1, 2, 3]:
            paragraph = self.__document.add_paragraph(style = 'l' + str(level))#添加段落,选择对应级别的段落样式
            run = paragraph.add_run(text)#在段落中添加文本
        else:
            raise SyntaxError(u'项目符号等级为1-3')

    def __latex_to_pic(self, text):#将Latex文本公式转为图片
        math_formula = '$%s#39; % text#将公式转为matplotlib库支持的语句
        plt.rcParams['font.sans-serif']=['SimHei'] # 用来正常显示中文标签
        plt.rcParams['axes.unicode_minus']=False # 用来正常显示负号
        fig = plt.figure(figsize = (20, 4), dpi = 160)#创建窗口
        ax = fig.add_axes([0,0,1,1])#添加坐标轴,便于后面文字定位
        ax.text(0.5, 0.5, math_formula,
                horizontalalignment='center',
                verticalalignment='center',
                fontsize=20, color='black',
                transform=ax.transAxes)#在中心添加文字
        ax.set_axis_off()#隐藏坐标轴
        plt.savefig('炜智能.png')#保存图片
        
        padding = (10,10,10,10)#边缘保留宽度
        color = (255, 255, 255)#白色RGB值
        img = Image.open('炜智能.png')#打开图片
        img = img.convert('RGB')#将图片转为RGB格式
        ivt_img = ImageOps.invert(img)#将颜色反转,方便后面getbbox()截取黑边
        bbox = ivt_img.getbbox()#截去黑色边缘
        left = bbox[0] - padding[0]#计算截取边界
        top = bbox[1] - padding[1]
        right = bbox[2] + padding[2]
        bottom = bbox[3] + padding[3]
        img = img.crop([left, top, right, bottom])#截取图片
        img = img.convert('RGBA')#转换图片格式为RGBA,增加一个透明度通道
        arr = np.array(np.asarray(img))#将图片数组化
        r, g ,b, a = np.rollaxis(arr, axis = -1)
        mask = (r == color[0]) & (g == color[1]) & (b == color[2])#筛选白色的像素点
        arr[mask, 3] = 0#将白点透明度调为0
        img = Image.fromarray(arr, mode = 'RGBA')#将数组转会图片
        img.save('炜智能.png')#保存图片

    def __picture(self, filename, width = None, height = None):#添加图片
        try:#将宽度值转为cm
            width = Cm(width)
        except:
            pass
        try:#将高度值转为cm
            height = Cm(height)
        except:
            pass
        paragraph = self.__document.add_paragraph()
        run = paragraph.add_run()
        paragraph_format = paragraph.paragraph_format
        font = run.font
        size = 12#小四号
        paragraph_format.alignment = WD_ALIGN_PARAGRAPH.CENTER#将图像居中
        paragraph_format.line_spacing_rule = WD_LINE_SPACING.ONE_POINT_FIVE#设置一点五倍行距
        paragraph_format.space_before = 0#设置段前为0倍行距
        paragraph_format.space_after = Pt(size / 2)
        font.name = '宋体'#设置字体名称
        font.size = Pt(size)#设置字体大小
        font.color.rgb = RGBColor(0, 0, 0)#设置字体颜色为黑
        font.bold = False#是否粗体
        font.italic = False#是否斜体

        run.add_picture(filename, width = width, height = height)#添加图像

    def add_latex(self, text):#添加公式段落
        self.__latex_to_pic(text)
        self.__picture('炜智能.png', height = 0.6)
        os.remove('炜智能.png')#删除插入公式的图片文件

    def add_picture(self, filename):#添加图片段落
        self.__picture(filename, width = 8.5)

    def read_text(self, filename):#读取txt文档转为Word
        with open(filename, 'r', encoding = 'UTF-8') as f:
            lines = f.readlines()
        for line in lines:
            line = line.rstrip('\n')#去掉字符串最后的换行符
            if line.startswith('# '):
                line = line.lstrip('# ')
                self.add_heading(line, 1)
            elif line.startswith('## '):
                line = line.lstrip('## ')
                self.add_heading(line, 2)
            elif line.startswith('### '):
                line = line.lstrip('### ')
                self.add_heading(line, 3)
            elif line.startswith('#### '):
                line = line.lstrip('#### ')
                self.add_heading(line, 4)
            elif line.startswith('##### '):
                line = line.lstrip('##### ')
                self.add_heading(line, 5)
            elif line.startswith('- '):
                line = line.lstrip('- ')
                self.add_list(line, 1)
            elif line.startswith('-- '):
                line = line.lstrip('-- ')
                self.add_list(line, 2)
            elif line.startswith('--- '):
                line = line.lstrip('--- ')
                self.add_list(line, 3)
            elif line.startswith('! '):
                line = line.lstrip('! ')
                try:
                    self.add_picture(line)
                except:
                    self.add_body('添加图片失败(%s)' % line)
            elif line.startswith('!'):
                line = line.lstrip('!')
                try:
                    self.add_picture(line)
                except:
                    self.add_body('添加图片失败(%s)' % line)
            elif line.startswith('$ '):
                line = line.lstrip('$ ')
                try:
                    self.add_latex(line)
                except:
                    self.add_body('添加公式失败(%s)' % line)
            elif line.startswith('¥ '):
                line = line.lstrip('¥ ')
                try:
                    self.add_latex(line)
                except:
                    self.add_body('添加公式失败(%s)' % line)
            else:
                self.add_body(line)
        self.save()


def main():#主函数
    os.chdir(os.path.abspath(os.path.dirname(sys.argv[0])))#切换工作目录至脚本所在位置
    doc = Word()#创建上面定义的类
    doc.read_text('demo.txt')#选择要转换的txt文件


if __name__ == '__main__':
    main()

代码中的样式定义语句其实也可以通过直接编写Word模板的方式实现,只需在最开始的self.__document = Document()语句中填入模板文件的地址即可,笔者之所以没有采用这种方式是因为不想外带一个模板文件,不介意的读者完全可以通过在模板中编写样式的方式来实现更多的样式设定。

代码中最后一个方法使用了大量的if条件判定并用了大量的重复代码,整体看上去略显繁琐,究其原因是笔者懒得想方法简化了,觉得不够优雅的读者可以自行改造一下,有好的思路的话也可以与笔者分享一下。

实例讲解

上面的代码看着复杂,其实大部分代码行都是用来定义样式风格和文本转换语法的,读者可以直接用笔者定义好的样式和文本转换语法,也可以以上面的代码为框架自己进行样式自定义或功能拓展,比如表格的支持。

学习使用的最好方式就是实例,下面笔者给出一份txt文件的编写实例,如果公司电脑有加密系统的话,此处建议使用notepad++来进行文件编写:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
正文效果展示(微信公众号:**炜智能**)
- 一级项目符号
-- 二级项目符号
--- 三级级项目符号
- 一级项目符号
-- 二级项目符号
--- 三级级项目符号
$ \mathit{\alpha = \beta +\gamma }
! weizhineng.png
##### 五级标题
  • 标题分为五级,用以若干#加单空格开头;一级标题用于文章标题,其文本会直接被用作Word文档文件名,此处需要注意,如果脚本所在工作目录下有同名Word文档,该文档会被直接替换;五级标题用于图片、表格等的说明;
  • 项目符号分为三级,以若干-加单空格开头;
  • 数学公式以$或¥加单空格开头,公式语法为Latex,如果公式错误的话会在生成的Word文档中提示;
  • 图片以!或!加单空格开头,如果图片与脚本文件在同一工作目录下可以只填写图片文件名,不然需要加上绝对路径,图片地址填写错误的话同样会在生成的Word文档中提示;
  • 没有以上述特殊语法开头的段落一律视为正文内容;
  • **为正文中的粗体语法,笔者为了编写方便,将其设为了分隔符,也就是说正文中是无法显示这两个星号的,而且当出现了奇数个双星号时会自动在最后补齐,使最后一个双星号后的字符也变为粗体。

笔者建议将脚本文件、待转换txt文件、需插入图片都放置在同一工作目录下,示意图如下:

执行脚本只需右击脚本,选择打开方式为Python即可,示意图如下:

执行完脚本后会在脚本所在工作目录下生成Word文档,此文档因为是用python-docx库编写的,所以即使是使用带加密功能的公司电脑生成也不会被加密,具体效果如下:

相关推荐

eino v0.4.5版本深度解析:接口类型处理优化与错误机制全面升级

近日,eino框架发布了v0.4.5版本,该版本在错误处理、类型安全、流处理机制以及代理配置注释等方面进行了多项优化与修复。本次更新共包含6个提交,涉及10个文件的修改,由2位贡献者共同完成。本文将详...

SpringBoot异常处理_springboot异常注解

在SpringBoot中,异常处理是构建健壮、可维护Web应用的关键部分。良好的异常处理机制可以统一返回格式、提升用户体验、便于调试和监控。以下是SpringBoot中处理异常的完整指...

Jenkins运维之路(Jenkins流水线改造Day02-1-容器项目)

这回对线上容器服务器的流水线进行了一定的改造来满足目前线上的需求,还是会将所有的自动化脚本都放置到代码库中统一管理,我感觉一章不一定写的完,所以先给标题加了个-1,话不多说开干1.本次流水线的流程设计...

告别宕机!零基础搭建服务器监控告警系统!小白也能学会!

前言本文将带你从零开始,一步步搭建一个完整的服务器指标监控与邮件告警系统,使用的技术栈均为业界主流、稳定可靠的开源工具:Prometheus:云原生时代的监控王者,擅长指标采集与告警规则定义Node_...

httprunner实战接口测试笔记,拿走不谢

每天进步一点点,关注我们哦,每天分享测试技术文章本文章出自【码同学软件测试】码同学公众号:自动化软件测试码同学抖音号:小码哥聊软件测试01开始安装跟创建项目pipinstallhttprunne...

基于JMeter的性能压测平台实现_jmeter压测方案

这篇文章已经是两年前写的,短短两年时间,JMeter开源应用技术的发展已经是翻天覆地,最初由github开源项目zyanycall/stressTestPlatform形成的这款测试工具也开始慢...

12K+ Star!新一代的开源持续测试工具!

大家好,我是Java陈序员。在企业软件研发的持续交付流程中,测试环节往往是影响效率的关键瓶颈,用例管理混乱、接口调试复杂、团队协作不畅、与DevOps流程脱节等问题都能影响软件交付。今天,给大家...

Spring Boot3 中分库分表之后如何合并查询

在当今互联网应用飞速发展的时代,数据量呈爆发式增长。对于互联网软件开发人员而言,如何高效管理和查询海量数据成为了一项关键挑战。分库分表技术应运而生,它能有效缓解单库单表数据量过大带来的性能瓶颈。而在...

离线在docker镜像方式部署ragflow0.17.2

经常项目上会出现不能连外网的情况,要怎么使用ragflow镜像部署呢,这里提供详细的步骤。1、下载基础镜像根据docker-compose-base.yml及docker-compose.yml中的i...

看,教你手写一个最简单的SpringBoot Starter

何为Starter?想必大家都使用过SpringBoot,在SpringBoot项目中,使用最多的无非就是各种各样的Starter了。那何为Starter呢?你可以理解为一个可拔插式...

《群星stellaris》军事基地跳出怎么办?解决方法一览

《群星stellaris》军事基地跳出情况有些小伙伴出现过这种情况,究竟该怎么解决呢?玩家“gmjdadk”分享的自己的解决方法,看看能不能解决。我用英文原版、德语、法语和俄语四个版本对比了一下,结果...

数据开发工具dbt手拉手教程-03.定义数据源模型

本章节介绍在dbt项目中,如何定义数据源模型。定义并引入数据源通过Extract和Load方式加载到仓库中的数据,可以使用dbt中的sources组件进行定义和描述。通过在dbt中将这些数据集(表)声...

docker compose 常用命令手册_docker-compose init

以下是DockerCompose常用命令手册,按生命周期管理、服务运维、构建配置、扩缩容、调试工具分类,附带参数解析、示例和关键说明,覆盖多容器编排核心场景:一、生命周期管理(核心命令...

RagFlow与DeepSeek R1本地知识库搭建详细步骤及代码实现

一、环境准备硬件要求独立显卡(建议NVIDIAGPU,8GB显存以上)内存16GB以上,推荐32GB(处理大规模文档时更高效)SSD硬盘(加速文档解析与检索)软件安装bash#必装组件Docker...

Docker Compose 配置更新指南_docker-compose配置

高效管理容器配置变更的最佳实践方法重启范围保留数据卷适用场景docker-composeup-d变更的服务常规配置更新--force-recreate指定/所有服务强制重建down→up流程...