用 Markdown 写博客:一篇示例,也是本站的格式说明

liulinhai 2026.10.27 20:52 29 0
Django技术 Markdown 写作 站点公告

收录于《把博客搬回家》第 5 篇

这篇文章是怎么来的

它不是用后台的可视化编辑器排出来的,而是用 Markdown 源码写成、然后一条命令发到站上的。

发布时用的是这个命令:

docker exec deploy-web-1 python manage.py publish_post article.md \
    --title "用 Markdown 写博客:一篇示例,也是本站的格式说明" \
    --tags "Markdown,写作,站点公告"

正文开头那段 --- 包围的内容叫 front-matter,用来声明标题、摘要、标签、分类:

---
title: "文章标题"
excerpt: "文章摘要"
tags: [Markdown, 写作]
category: Django技术
status: p
---

正文从这里开始……

排版能力一览

Markdown 源文本在这里,页面上会显示为正常段落。粗体、斜体、行内代码 都能正确显示。

引用块长这样:左侧一条竖线,文字略微倾斜,用来放引述或提示。

表格

能力 写法 支持情况
标题 # 标题 ✅
粗体 / 斜体 **粗** / *斜* ✅
行内代码 `code` ✅
围栏代码块 ```lang ✅ 带语法高亮
表格 \| 列 \| 列 \| ✅
引用块 > 引用 ✅
列表 - 项 / 1. 项 ✅ 支持嵌套
分隔线 --- ✅
链接 [文字](地址) ✅
图片 ![说明](地址) ✅ 自动限宽

代码高亮

Python 代码:

def render_body(body, content_format):
    """把数据库里的原文转成页面要显示的 HTML。"""
    if content_format == FORMAT_MARKDOWN:
        return mark_safe(_markdown_to_html(body))
    return mark_safe(body)

Shell 命令:

curl -s --noproxy '*' -m 15 -o /dev/null -w "HTTP %{http_code}\n" http://siliu.online/

列表

无序列表:

  • 第一项
  • 第二项
  • 嵌套一项
  • 嵌套二项
  • 第三项

有序列表:

  1. 第一步
  2. 第二步
  3. 第三步

写在最后

从这篇开始,博客可以有两种写法:后台的可视化编辑器适合随手记,Markdown 源码适合写带表格和代码的技术文章。

两种格式可以混用——每篇文章各自记录自己用的是哪一种,页面按各自的方式渲染,互不干扰。

Last Modified·2026年10月27日 21:01

暂无评论

您尚未登录,请先才能评论。