diff --git a/docs/Content-Filters.md b/docs/Content-Filters.md
index 227d6bf..4ce8e08 100644
--- a/docs/Content-Filters.md
+++ b/docs/Content-Filters.md
@@ -18,7 +18,7 @@ syntax is used.
> complex filters. It is suggested to test filters using ``Feed debugger`` (hotkey `f-D`) if you
> feel that some filter is somehow misfiring on a specific feed.
-### Load order
+## Load order
Filters are loaded in user-specified order and applied sequentially. It is
possible to reorder filters using drag and drop. If no manual sorting is
@@ -26,7 +26,7 @@ specified, filters are sorted alphabetically according to user configured
caption. If no caption is specified for any filter, loading order is not
guaranteed.
-### Filter objects
+## Filter objects
Each filter object may contain an arbitrary amount of regular expression rules
and actions. Each expression may have inverse flag set, which inverts matching
@@ -41,7 +41,7 @@ as, title, content, author, etc.
{: .warning }
> Do not include delimiters (e.g. /) when writing regular expressions.
-### Matching articles and applying actions
+## Matching articles and applying actions
Filter matching is performed during feed processing.
diff --git a/docs/Scoring.md b/docs/Scoring.md
index be34551..581984f 100644
--- a/docs/Scoring.md
+++ b/docs/Scoring.md
@@ -4,7 +4,7 @@ title: Scoring
parent: Features
---
-Scoring is supported in a way similar to some newsreaders. Score is calculated
+Scoring is supported in a way similar to some news readers. Score is calculated
on article import using special filters with a "Modify score" action.
Resulting score is a sum of all score modifiers from all matching filters. For
@@ -15,16 +15,16 @@ Article score affects the position of the article in the headline buffer (which
is sorted by score) and alters the way article is displayed:
| Score | Display / Action |
-|-------|------------------|
+| --- | --- |
| `<-500` | Score indicator points down, article is automatically marked as read |
| `<-100` | Score indicator points down |
-| `<0` | Score indicator points down, 1.5.0: article is excluded from Fresh feed and (as of 1.5.10 also excluded from email digest) |
-| `0` | Display normally |
-| `>0` | Score indicator points up |
-| `>500` | Score indicator points up |
+| `<0` | Score indicator points down, 1.5.0: article is excluded from Fresh feed and (as of 1.5.10 also excluded from email digest) |
+| `0` | Display normally |
+| `>0` | Score indicator points up |
+| `>500` | Score indicator points up |
| `>1000` | Same as above, article is also marked as starred |
-### Adjusting manually
+## Adjusting manually
Calculated score for an individual article may be adjusted by clicking on score
indicator in the headlines list:
diff --git a/docs/Sorting.md b/docs/Sorting.md
index b3840f8..f885eb9 100644
--- a/docs/Sorting.md
+++ b/docs/Sorting.md
@@ -4,8 +4,10 @@ title: Sorting
parent: Features
---
+## Sort Options
+
Tiny Tiny RSS provides four options for how articles appear within a
-selected feed: `Default`, `Newest`, `Oldest`, `Title`.
+selected feed: `Default`, `Newest first`, `Oldest first`, `Title`.
{: .note }
> Special feeds (e.g. *Starred articles*) have unique sorting when *Default* is selected, otherwise they behave as described below.
@@ -22,11 +24,11 @@ This is the default (surprise!) and is recommended.
2. Descending date/time the article was added into the Tiny Tiny RSS database.
3. Descending date/time the feed's site states the article was published or changed.
-### Newest
+### Newest first
1. Descending date/time the feed's site states the article was published or changed.
-### Oldest
+### Oldest first
1. Ascending date/time the feed's site states the article was published or changed.
diff --git a/docs/Themes.md b/docs/Themes.md
index 98c0f01..befc8fe 100644
--- a/docs/Themes.md
+++ b/docs/Themes.md
@@ -8,7 +8,7 @@ Install by copying theme CSS (and any other content, if needed) into ``themes.lo
**Please note that we’re not responsible for third party themes. Use at your own risk.**
-### FeedMei Theme + Plugins for Tiny Tiny RSS
+## FeedMei Theme + Plugins for Tiny Tiny RSS
@@ -17,7 +17,7 @@ A clean and minimal theme for Tiny Tiny RSS, loosely inspired by Feedly. Built b
**Codeberg**
-### Clean GReader Theme
+## Clean GReader Theme
@@ -26,7 +26,7 @@ Google Reader it has a white/greyish look.
**Github**
-### Feedly Theme
+## Feedly Theme
@@ -34,7 +34,7 @@ A theme built from scratch, independent of default css. Emulates the greyish loo
**Github**
-### Reeder Theme
+## Reeder Theme