Markdown API for Medium
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


A Markdown API for Medium that deploys to AWS Lambda.


Change the domain name of a Medium post URL to to view as Markdown. The http protocol and the domain will be automatically assumed for domain posts. For publications with custom domains the full URL should be provided.

# with protocol and medium domain

# without protocol

# without medium domain

# publication with custom domain

Building and deploying

Ensure you have SBT, the Serverless Framework and the AWS CLI installed. The required AWS infrastructure defined in serverless.yml will be automatically created on first deploy. The custom domain then needs manually configuring for the S3 bucket and API Gateway endpoint. The website is expected to be hosted from the bucket at the domain root and the API hosted on the md subdomain. Optionally the www subdomain can be assigned to the bucket to redirect www requests to the root domain.

# running the test suite
(cd api && sbt test)

# building the API using sbt assembly

# deploying the API using serverless framework

# deploying the website to S3 bucket

Basic request analytics can be sent to Google Analytics. To enable, configure two environment variables for the AWS Lambda handler with the Google Analytics tracking ID and custom domain name with ANALYTICS_TRACKING_ID and ANALYTICS_TRACKING_HOST respectively.


This project is licensed under the MIT License.