1. Johngo学长首页
  2. 技术点详细复盘专题
  3. Python

用Python基础知识实现了一个在线的markdown编辑工具、基于Editor.md、Flask、Flask_SQLAlchemy、sm.ms

• Python • 阅读 53

在线markdown平台搭建

文章目录

前言

我打算把我的域名用于图床了，网站后面可能访问就不太行了
【系统已经升级啦，快看这里 】

所谓天下代码一大抄，抄来抄去有提高，用来描述编程再合适不过了，今天我也抄了一波。我通过开源+借鉴的方式，自己搞了一个在线的 markdown编辑器，没错这篇文章就是在上面写的。

话不多说，先上图，下面就是我抄的成果：

用Python基础知识实现了一个在线的markdown编辑工具、基于Editor.md、Flask、Flask_SQLAlchemy、sm.ms
用Python基础知识实现了一个在线的markdown编辑工具、基于Editor.md、Flask、Flask_SQLAlchemy、sm.ms
用Python基础知识实现了一个在线的markdown编辑工具、基于Editor.md、Flask、Flask_SQLAlchemy、sm.ms

; 目的

我之前一直都是使用 vscode敲各种代码的，我非常喜欢这个工具，主要是颜值把住了我，其次通过插件可以支持非常多的语言，通用性非常高，上一个被我这么宠幸的IDE还是 eclipse。

我写文章使用的是 markdown，之前也用过富文本编辑器，相比于 markdown，富文本编辑器更多样，这是优势也是劣势。主要的缺点是写出来的文章比较花哨（对我来说，有很多读者都喜欢这种），而且非常容易造成自己写的文章格式风格不统一。

我一直用 vscode编写 markdown， Markdown All in One这个插件非常的神器，基本上能用到的功能都有涉及。

问题在于代码的同步，最初都是用 Gitee，因为 GitHub老是打不开。我这人有一个毛病，不喜欢同步代码，这就导致家里和公司的代码出现了不匹配，很烦。

当然，代码同步只是一个方面，最主要的是，如果在公司打开一个黑乎乎的 vscode很引人注意（我的岗位不需要敲代码），这就有了 划水的嫌疑。

另外呢，我买的还有两台服务器，域名也收藏了好多，正好用上。其实用 vscode连接远端服务器也蛮好的，但是问题还是在工位上打开 vscode不合适~~
（把 vscode改成 light主题？？哈哈）

话说我还买了好几个中文域名，太费钱了

需求

为了解决我遇到的困扰，我收集了一下我的主要矛盾：

  1. 代码自动同步；
  2. 界面简洁低调；
  3. 良好的markdown编辑体验

我目前了解到的、喜欢的开源在线编辑工具主要有两个：

  1. Editor.md
  2. CKEditor

Editor.md是一个网页版的 markdown编辑器，界面风格非常简洁， Demo也非常丰富，也是本文的选择。遗憾的是代码库停止更新了。

CKEditor是一个富文本编辑器，就能力上来说，更强，但是是一个富文本编辑器，虽然支持 markdown，对我来说有那么一奈奈的功能过剩。

这两款编辑工具都非常优秀，我非常喜欢，只恨自己不是开发者~~

设计

原计划只做一个页面，其他功能以弹窗的方式实现，但是 Editor和 bootstrap等前端框架有冲突，自己前端水平有限，做不出好看的界面，就能简则简。

前端页面设计

页面包括三个：

  1. 登录/注册页，登录注册二合一；
  2. 文章列表页，展示编辑过的文章；
  3. 编辑页面，使用 Editor.md实现；

后端框架选择

所谓，人生苦短，我用 Python，顺理成章的就选择了 Flask作为后端框架。

Flask框架

简单介绍一下 Flask， Python服务器开发的流行框架，非常的轻量，同时插件很丰富，文档也齐全，有兴趣的童鞋可以访问官网，或则访问我之前写的文章《我用Python写网站》，文章写的比较粗，但是基本的注意事项都提到了。

数据库选择

sqlite是常用的单机数据库解决方案，完全能够满足我当前的需求，就不折腾 MySQL了。也非常推荐简单玩玩的童鞋使用， MySQL如果不是老鸟，太难了~💔

我之前的文章使用的是 MySQL，详细介绍了如何连接数据库，使用起来都差不多。

连接数据库的工具是flask-sqlalchemy， SQLAlchemy是一个 ORM（ Object Relational Mapper）框架，简单来讲，就是可以在不写 sql的情况下完成各种数据库操作。

图床sm.ms

因为贫穷，只能使用免费的图床平台，这里我用的是sm.ms。

市面上有很多图床可以选择，一般都有免费空间赠送， sm.ms有 5GB的免费空间，支持 API上传，不过访问速度一般，可能因为我是白嫖的。

关键是不需要注册就能使用，直接上传图片就可以获得链接。

用Python基础知识实现了一个在线的markdown编辑工具、基于Editor.md、Flask、Flask_SQLAlchemy、sm.ms

; 实现

下面是抄袭教程：

数据库设计

数据库使用 flask-sqlalchemy连接，详细操作在《我用Python写网站》中都有讲解。

下面的代码涉及了 flask-sqlalchemy的使用方法、 flask-cli命令行的使用。

可以简单的使用 flask db-init、 flask db-rebuild等命令操作数据库。

话不多说，上代码：


from email.policy import default
from flask_sqlalchemy import SQLAlchemy
import sqlite3
import click
from flask.cli import with_appcontext
from datetime import datetime
from werkzeug.security import generate_password_hash, check_password_hash
from flask_login import UserMixin

db = SQLAlchemy()

def addUser(u):
    if isinstance(u, User):
        db.session.add(u)
        db.session.commit()

def updatePost(p):
    if isinstance(p, Post):
        db.session.add(p)
        db.session.commit()

def init_app(app):
    db.init_app(app)
    app.cli.add_command(init_db_command)
    app.cli.add_command(reb_db_command)
    app.cli.add_command(del_db_command)

def init_data():
    admin = User(username='admin', password='996996', email='666@163.com')
    db.session.add(admin)
    db.session.flush()
    db.session.commit()
    post = Post(title='第一篇文章', html='# 第一篇文章', markdown='# 第一篇文章')
    post.author_id = admin.id
    db.session.add(post)
    db.session.commit()
    anonym = User(username='anonym', password='996996', email='666@666.com')
    db.session.add(anonym)
    db.session.commit()

def init_db():
    db.create_all()
    init_data()

def del_db():
    db.drop_all()

@click.command('db-rebuild')
@with_appcontext
def reb_db_command():
    del_db()
    init_db()
    click.echo('Rebuild the database.')

@click.command('db-clean')
@with_appcontext
def del_db_command():
    del_db()
    click.echo('Cleared the database.')

@click.command('db-init')
@with_appcontext
def init_db_command():
    init_db()
    click.echo('Initialized the database.')

class ShareField(object):
    created = db.Column(
        db.DateTime, nullable=False, default=datetime.utcnow)
    updated = db.Column(db.DateTime, onupdate=datetime.utcnow)
    status = db.Column(db.Integer, default=0)

class User(db.Model, ShareField, UserMixin):
    __tablename__ = 't_users'
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(80),  nullable=False)
    _password = db.Column(db.String(128),  nullable=False)
    email = db.Column(db.String(120), unique=True, nullable=False)
    posts = db.relationship('Post', backref='author', lazy=True)

    def __init__(self, username, password, email):
        self.username = username
        self.password = password
        self.email = email

    @property
    def password(self):
        return self._password

    @password.setter
    def password(self, raw_password):
        self._password = generate_password_hash(raw_password)

    def check_password(self, raw_password):
        result = check_password_hash(self.password, raw_password)
        return result

class Post(db.Model, ShareField):
    __tablename__ = 't_posts'
    id = db.Column(db.Integer, primary_key=True)
    title = db.Column(db.String(64), nullable=False, default='')
    html = db.Column(db.String(30000), nullable=False, default='')
    markdown = db.Column(db.String(30000), nullable=False, default='')
    author_id = db.Column(db.Integer, db.ForeignKey(
        't_users.id'), nullable=False)

登录注册

首先，去 csdn上搜个登录注册页面源代码！

用Python基础知识实现了一个在线的markdown编辑工具、基于Editor.md、Flask、Flask_SQLAlchemy、sm.ms

我选择的是《好看实用的HTML登录界面》

稍微改改里面的 form代码，以下仅供参考：

<div class="container__form container--signup">
      <form action="{{url_for('auth.register')}}" method="post" class="form" id="form1">
        <h2 class="form__title">Sign Uph2>
        <input type="text" name="username" placeholder="UserName" class="input" />
        <input type="email" name="email" placeholder="Email" class="input" />
        <input type="password" name="password" placeholder="Password" class="input" />
        <input type="submit" class="btn" value="Sign Up">input>
      form>
    div>

    <div class="container__form container--signin">
      <form action="{{url_for('auth.login')}}" method="post" class="form" id="form2">
        <h2 class="form__title">Sign Inh2>
        <input type="email" name="email" placeholder="Email" class="input" />
        <input type="password" name="password" placeholder="Password" class="input" />
        <a href="#" class="link">Forgot your password?a>
        <input type="submit" class="btn" value="Sign In">input>
      form>
    div>

后端使用 flask-login插件完成登录，如果不会用这个插件的，可以访问我之前的文章《我用Python写网站》。

@bp.route('/register', methods=['POST', 'GET'])
def register():
    if request.method == 'POST':
        email = request.form.get('email', '')
        username = request.form.get('username', '')
        password = request.form.get('password', '')
        if email == '' or username == '' or password == '':
            flash('注册信息不完整')
            return {'msg': '注册信息不完整'}, 201
        user = User.query.filter_by(email=email).first()
        if user:
            flash('邮箱已注册')
            return {'msg': '邮箱已注册'}, 201

        user = User(email=email,username=username,password=password)
        addUser(user)
        return redirect(url_for('auth.login'))
    return render_template('sigh.html')

@bp.route('/login', methods=['POST', 'GET'])
def login():
    if request.method == 'POST':
        email = request.form.get('email', '')
        password = request.form.get('password', '')
        print(email, password)
        if email == '' or password == '':
            flash('登录信息不完整')
            return {'msg': '登录信息不完整'}, 201
        user = User.query.filter_by(email=email).first()
        if not user:
            flash('用户不存在')
            return {'msg': '用户不存在'}, 404

        if not user.check_password(password):
            flash('密码错误')
            return {'msg': '密码错误'}, 201
        login_user(user)
        return redirect(url_for('post.all'))
    return render_template('sign.html')

以上代码写的非常粗糙，基本上没有异常的处理，而且登录失败没有页面跳转😫，可以稍微改下。

文章编辑

主要是 Editor.md的引入，同样的，《我用Python写网站》里面也都有，我这里直接上代码：

index.html
{% extends 'base.html' %}

{% block style %}
{{super()}}

<link rel="stylesheet" href="{{ url_for('static',filename='css/editormd.css')}}" />
{% endblock %}

{% block content %}
<div class="main_content">
    <div class="center_content">
        <div class="btn-group">

            <button id="show-btn">Show editorbutton>
            <button id="hide-btn">Hide editorbutton>
            <button id="get-md-btn">Get Markdownbutton>
            <button id="get-html-btn">Get HTMLbutton>
            <button id="show-toolbar-btn">Show toolbarbutton>
            <button id="close-toolbar-btn">Hide toolbarbutton>
            {% if current_user.is_authenticated %}
            <a class="link-btn" href="{{url_for('auth.logout')}}">Quita>
            <a class="link-btn" href="{{url_for('post.all')}}">Post Lista>
            {% else %}
            <a class="link-btn" href="{{url_for('auth.register')}}">Sign Upa>
            <a class="link-btn" href="{{url_for('auth.login')}}">Sign Ina>
            {%endif%}
        div>

        <input id="title" name="title" type="text" value="{{target.title}}" style="width: 100%;" placeholder="请输入文章标题">
    div>

    <div id="test-editormd">
        <textarea style="display: none;">{% if target %}{{ target.markdown}}{% else %}{% endif %}textarea>
    div>
div>
{% endblock %}

{% block script %}
{{super()}}
<script src="{{ url_for('static',filename='js/editormd.js')}}">script>
<script type="text/javascript">
    function debounce(func, wait, immediate) {
        let timeout
        return function (...args) {
            clearTimeout(timeout)
            timeout = setTimeout(() => {
                timeout = null
                if (!immediate) func.apply(this, args)
            }, wait)
            if (immediate && !timeout) func.apply(this, [...args])
        }
    };

    function update() {
        title = $('#title').val();
        html = testEditor.getHTML();
        mark = testEditor.getMarkdown();
        data = {
            title: title,
            html: html,
            markdown: mark
        }
        $.ajax({
            url: '{{url_for("post.edit",id=target.id)}}',
            data: JSON.stringify(data),
            method: 'post',
            dataType: 'json',
            contentType: 'application/json',
            success: function (data) {
                console.log(data.msg);
            }
        });
    }

    $('#title').on('input', debounce(update, 3000, false));

    var testEditor;
    $(function () {

        testEditor = editormd("test-editormd", {
            width: "90%",
            height: 740,
            path: '{{url_for("static",filename="editor.md/lib/")}}',

            codeFold: true,

            saveHTMLToTextarea: true,
            searchReplace: true,

            htmlDecode: "style,script,iframe|on*",

            emoji: true,
            taskList: true,
            tocm: true,
            tex: true,
            flowChart: true,
            sequenceDiagram: true,

            imageUpload: true,
            imageFormats: ["jpg", "jpeg", "gif", "png", "bmp", "webp"],
            imageUploadURL: "{{url_for('post.upload')}}",
            onload: function () {
                console.log('onload', this);

            },
            onchange: debounce(update, 3000, false),
        });

        $("#goto-line-btn").bind("click", function () {
            testEditor.gotoLine(90);
        });

        $("#show-btn").bind('click', function () {
            testEditor.show();
        });

        $("#hide-btn").bind('click', function () {
            testEditor.hide();
        });

        $("#get-md-btn").bind('click', function () {
            alert(testEditor.getMarkdown());
        });

        $("#get-html-btn").bind('click', function () {
            alert(testEditor.getHTML());
        });

        $("#watch-btn").bind('click', function () {
            testEditor.watch();
        });

        $("#unwatch-btn").bind('click', function () {
            testEditor.unwatch();
        });

        $("#preview-btn").bind('click', function () {
            testEditor.previewing();
        });

        $("#fullscreen-btn").bind('click', function () {
            testEditor.fullscreen();
        });

        $("#show-toolbar-btn").bind('click', function () {
            testEditor.showToolbar();
        });

        $("#close-toolbar-btn").bind('click', function () {
            testEditor.hideToolbar();
        });

        $("#toc-menu-btn").click(function () {
            testEditor.config({
                tocDropdown: true,
                tocTitle: "目录 Table of Contents",
            });
        });

        $("#toc-default-btn").click(function () {
            testEditor.config("tocDropdown", false);
        });
    });
script>
{% endblock %}

简单解释一下，下载 Editor.md压缩包，解压后放在 static文件夹下面，重命名为 editor.md，页面中的 css和 js文件都可以直接抄 editor.md/expample/full.html的引用方式，然后换成 jinja的格式就可以了。

需要注意的是：

  1. 自动保存
    自动保存功能使用 onchange实现， Editor.md留的有接口，我在这里使用了一个防抖动的技术，说白了就是在文章修改后的第一时间不上传，而是等停止改动后3秒再上传，这样可以有效的降低服务器压力。
  2. 图片上传
    图片上传使用 imageUploadURL指定上传路径。我这里没有把图片保存在自己的服务器，而是转手把图片上传到了 sm.ms，下面会有详细的实现代码。

文章保存后端代码

@bp.route('/edit/', methods=['POST', 'GET'])
@login_required
def edit(id=0):
    target = Post.query.filter_by(id=id).first()
    if not target:
        return {'msg': '服务器没有查询到当前文章的信息！'}, 404

    if request.method == 'POST':
        data = request.json
        target.title = data['title']
        target.html = data['html']
        target.markdown = data['markdown']
        print(target.html, target.markdown)
        updatePost(target)
        return {'msg': 'success'}, 200
    return render_template('index.html', target=target)

@bp.route('/all')
@login_required
def all():
    post_list = current_user.posts
    return render_template('posts.html', post_list=post_list)

@bp.route('/upload', methods=['POST'])
@login_required
def upload():
    img = request.files.get('editormd-image-file')
    if not img:
        return {'success': 0, 'message': 'null'}
    headers = {'Authorization': '这里需要写自己的授权码'}
    files = {'smfile': img}
    url = 'https://sm.ms/api/v2/upload'
    res = requests.post(url, files=files, headers=headers).text
    import json
    js = json.loads(res)
    if js.get('success') == True:
        url = js.get('data').get('url')
    else:
        url = js.get('images')

    msg = js.get('message')
    return {'success': 1, 'message': msg, 'url': url}

edit方法用于更新文章， upload方法用于图片上传。

可以看到代码写的非常脆弱，大佬不要嘲讽我~~

图片上传里面有一个需要注意的地方，就是 headers变量中的 Authorization值。
这个值需要自己注册 sm.ms才能获得，获得方法如下图：

用Python基础知识实现了一个在线的markdown编辑工具、基于Editor.md、Flask、Flask_SQLAlchemy、sm.ms

文章列表

列表页面也是我自己写的唯一一个页面，主要没得抄，当然也是非常简单的。

功能就是展示所有的文章，也没有使用分页功能。

后端代码就是上面代码的 all()函数，这里不再重复，简单贴一下前端代码：

posts.html
{% extends 'base.html' %}
{% block style %}
{{super()}}

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.8.1/font/bootstrap-icons.css">
{% endblock %}

{% block content %}
<div class="main_content">
    <div class="center_content">
        <div>
            <span style="font-size: 18px;font-weight: bold ;">文章列表span>
            {% if current_user.is_authenticated %}
            <a class="link-btn" href="{{url_for('auth.logout')}}">Quita>
            {% else %}
            <a class="link-btn" href="{{url_for('auth.register')}}">Sign Upa>
            <a class="link-btn" href="{{url_for('auth.login')}}">Sign Ina>
            {%endif%}
        div>


        <ul class="post_list">
            <li><a href="{{url_for('post.add')}}" style="color: rgb(45, 141, 128);"><i class="bi bi-plus-circle">i>
                    Create a new
                    posta>li>
            {% if post_list %}
            {% for post in post_list | reverse %}
            <li>
                <a href="{{url_for('post.edit',id=post.id)}}"> {{ post.created.strftime('%Y-%m-%d %H:%M:%S')}}《{{
                    post.title}}》 a>
            li>
            {% endfor %}
            {% endif %}
        ul>
    div>
div>
{% endblock %}

这里没啥好解释的，还是那句话，如果有兴趣可以看我之前的文章《我用Python写网站》。

欢迎大家留言讨论，这点我还算熟悉~~~

还有图标呢~~~
😍

代码压缩包下载

文章pdf下载

【系统已经升级啦，快看这里 】

Original: https://blog.csdn.net/weixin_43302112/article/details/124367102
Author: @魏大大
Title: 用Python基础知识实现了一个在线的markdown编辑工具、基于Editor.md、Flask、Flask_SQLAlchemy、sm.ms

原创文章受到原创版权保护。转载请注明出处：https://www.johngo689.com/750446/

转载文章受原作者版权保护。转载请注明原作者出处！

赞 (0)
0

【自取】最近整理的，有需要可以领取学习：



Linux核心资料大放送~

全栈面试题汇总（持续更新&可下载）

一个提高学习100%效率的工具！

【超详细】深度学习面试题目！

LeetCode Python刷题答案下载！

LeetCode Java版刷题答案下载！

LeetCode C++ 版本，抓紧保存！

LeetCode GO语言 刷题答案下载！

大家都在看

亲爱的 Coder【最近整理，可免费获取】👉 最新必读书单  | 👏 面试题下载  | 🌎 免费的AI知识星球